{"id":21194145,"url":"https://github.com/petrknap/php-singleton","last_synced_at":"2025-07-03T15:36:11.367Z","repository":{"id":57038273,"uuid":"49267929","full_name":"petrknap/php-singleton","owner":"petrknap","description":"Singleton pattern for PHP","archived":false,"fork":false,"pushed_at":"2025-04-12T19:15:45.000Z","size":39,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-15T19:06:33.579Z","etag":null,"topics":["design-pattern","php","php-library","singleton","singleton-pattern"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/petrknap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-01-08T11:14:36.000Z","updated_at":"2025-04-12T17:36:36.000Z","dependencies_parsed_at":"2024-04-27T11:42:12.275Z","dependency_job_id":"e7039cbd-9f3e-48a1-bc85-b76078276b4e","html_url":"https://github.com/petrknap/php-singleton","commit_stats":{"total_commits":8,"total_committers":1,"mean_commits":8.0,"dds":0.0,"last_synced_commit":"7d37f9e5bdff3368b39c80ec2c70142f21255488"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/petrknap/php-singleton","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petrknap%2Fphp-singleton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petrknap%2Fphp-singleton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petrknap%2Fphp-singleton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petrknap%2Fphp-singleton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/petrknap","download_url":"https://codeload.github.com/petrknap/php-singleton/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petrknap%2Fphp-singleton/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261397040,"owners_count":23152472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["design-pattern","php","php-library","singleton","singleton-pattern"],"created_at":"2024-11-20T19:19:50.710Z","updated_at":"2025-07-03T15:36:11.331Z","avatar_url":"https://github.com/petrknap.png","language":"PHP","readme":"# Singleton pattern for PHP\n\nSimple implementation of singleton (anti-)pattern.\n\n\n## Why use a singleton?\n\nBecause it can solve deadlocks and other problems. See this example:\n\n```php\nclass UnsafeFileAppender\n{\n    const MY_FILE = '/tmp/my.file';\n\n    private $handle = null;\n\n    public function __construct()\n    {\n        $this-\u003ehandle = fopen(self::MY_FILE, 'a');\n        flock($this-\u003ehandle, LOCK_EX);\n    }\n\n    public function __destruct()\n    {\n        flock($this-\u003ehandle, LOCK_UN);\n        fclose($this-\u003ehandle);\n    }\n}\n```\n\nYou cannot create two instances at the same time with this code...\n\n```php\n$first = new UnsafeFileAppender();  // OK\n$second = new UnsafeFileAppender(); // Deadlock\n```\n\n...so simply convert it into singleton...\n\n```php\nuse PetrKnap\\Singleton\\SingletonInterface;\nuse PetrKnap\\Singleton\\SingletonTrait;\n\nclass SafeFileAppender extends UnsafeFileAppender implements SingletonInterface\n{\n    use SingletonTrait;\n\n    private function __construct()\n    {\n        parent::__construct();\n    }\n}\n```\n\n...and use the same instance twice.\n\n```php\n$first = SafeFileAppender::getInstance();  // OK\n$second = SafeFileAppender::getInstance(); // OK\n```\n\n---\n\nRun `composer require petrknap/singleton` to install it.\nYou can [support this project via donation](https://petrknap.github.io/donate.html).\nThe project is licensed under [the terms of the `LGPL-3.0-or-later`](./COPYING.LESSER).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetrknap%2Fphp-singleton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpetrknap%2Fphp-singleton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetrknap%2Fphp-singleton/lists"}