{"id":20346026,"url":"https://github.com/andkom/php-berkeley-db","last_synced_at":"2025-08-12T22:42:46.688Z","repository":{"id":56947738,"uuid":"141552355","full_name":"andkom/php-berkeley-db","owner":"andkom","description":"A simple Berkeley DB library for PHP.","archived":false,"fork":false,"pushed_at":"2018-09-15T07:02:37.000Z","size":11,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-05T01:57:04.284Z","etag":null,"topics":["berkeley","berkeley-db","database","library","php","php-library"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andkom.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-19T08:59:43.000Z","updated_at":"2025-04-14T17:49:58.000Z","dependencies_parsed_at":"2022-08-21T08:20:10.049Z","dependency_job_id":null,"html_url":"https://github.com/andkom/php-berkeley-db","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/andkom/php-berkeley-db","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andkom%2Fphp-berkeley-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andkom%2Fphp-berkeley-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andkom%2Fphp-berkeley-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andkom%2Fphp-berkeley-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andkom","download_url":"https://codeload.github.com/andkom/php-berkeley-db/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andkom%2Fphp-berkeley-db/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270148570,"owners_count":24535701,"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","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["berkeley","berkeley-db","database","library","php","php-library"],"created_at":"2024-11-14T22:11:01.734Z","updated_at":"2025-08-12T22:42:46.647Z","avatar_url":"https://github.com/andkom.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PHP Berkeley DB\n\nSimple Berkeley DB wrapper for PHP.\n\n## Installation\n\n**Download Berkeley DB source:**\n\n```bash\nwget 'http://download.oracle.com/berkeley-db/db-x.x.x.tar.gz'\ntar -xzvf db-x.x.x.tar.gz\n```\n\n**Build Berkeley DB libraries and headers:** \n\n```bash\ncd db-x.x.x/build_unix/\n../dist/configure --enable-cxx\nmake\nmake install\n```\n\n**Install php_db4 extension for \"phpdb4\" adapter (better):**\n\nBuild db4 extension:\n\n```bash\ncd ../lang/php4_db\nphpize\n./configure --with-db4=/usr/local/BerkeleyDB.x.x\nmake\nmake install\n```\n\nAdd db4 extension to php.ini:\n\n```ini\nextension=db4.so\n```\n\n**Or install db4 DBA handler for \"dba\" adapter:**\n\nBuild PHP with db4 support:\n\n```bash\n./configure --with-db4=/usr/local/BerkeleyDB.x.x\nmake\nsudo make install\n```\n\n**Install composer package:**\n\n```bash\ncomposer install andkom/php-berkeley-db\n```\n\n## Usage\n\n**Create instance:**\n\n```PHP\nuse AndKom\\BerkeleyDb\\Adapter\\AdapterFactory;\n\n$adapter = AdapterFactory::create(); // use first available adapter\n$adapter = AdapterFactory::create(\"phpdb4\"); // use phpdb4 adapter\n$adapter = AdapterFactory::create(\"dba\"); // use dba adapter\n```\n\n**Open database for reading:**\n\n```PHP\n$adapter-\u003eopen(\"filename\", \"r\");\n```\n\n**Open database with optional database name:**\n\n```PHP\n$adapter-\u003eopen(\"filename\", \"r\", \"main\");\n```\n\n**Open database for writing:**\n\n```PHP\n$adapter-\u003eopen(\"filename\", \"w\");\n```\n\n**Close database:**\n\n```PHP\n$adapter-\u003eclose();\n```\n\n**Sync changes to database:**\n\n```PHP\n$adapter-\u003esync();\n```\n\n**Read key value:**\n\n```PHP\n$value = $adapter-\u003eget(\"key\");\n```\n\n**Write key value:**\n\n```PHP\n$adapter-\u003eput(\"key\", \"value\");\n```\n\n**Delete key:**\n\n```PHP\n$adapter-\u003edelete(\"key\");\n```\n\n**Returns first key and moves cursor to the next position:**\n\n```PHP\n$adapter-\u003efirstKey();\n```\n\n**Read next key and moves cursor to the next position:**\n\n```PHP\n$adapter-\u003enextKey();\n```\n\n**Read all database keys:**\n\n```PHP\nforeach ($adapter-\u003eread() as $key =\u003e $value) {\n    ...\n}\n```\n\n### Laravel Service Provider\n\n**Publish configuration to app config:**\n\n```bash\n./artisan vendor:publish --provider=AndKom\\\\BerkeleyDb\\\\ServiceProvider\n```\n\n**Edit app/config/berkeleydb.php:**\n\n```PHP\n\u003c?php\n \nreturn [\n    'adapter' =\u003e 'phpdb4',\n \n    'filename' =\u003e database_path('database.dat'),\n \n    'database' =\u003e null,\n \n    'mode' =\u003e 'w',\n];\n\n```\n\n**Use BDB facade to access database methods:**\n\n```PHP\n$value = BDB::get(\"key\");\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandkom%2Fphp-berkeley-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandkom%2Fphp-berkeley-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandkom%2Fphp-berkeley-db/lists"}