{"id":21819355,"url":"https://github.com/dflydev/dflydev-dot-access-data","last_synced_at":"2025-05-14T11:11:04.665Z","repository":{"id":2962040,"uuid":"3976623","full_name":"dflydev/dflydev-dot-access-data","owner":"dflydev","description":"Given a deep data structure representing a configuration, access configuration by dot notation.","archived":false,"fork":false,"pushed_at":"2024-07-08T12:28:20.000Z","size":128,"stargazers_count":684,"open_issues_count":3,"forks_count":18,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-05-13T00:38:53.734Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/dflydev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-04-09T22:23:02.000Z","updated_at":"2025-05-08T14:22:13.000Z","dependencies_parsed_at":"2022-08-08T16:00:02.071Z","dependency_job_id":"ef7f5ec5-8958-4add-80a9-6f0d4f0a496a","html_url":"https://github.com/dflydev/dflydev-dot-access-data","commit_stats":{"total_commits":73,"total_committers":14,"mean_commits":5.214285714285714,"dds":0.3972602739726028,"last_synced_commit":"a23a2bf4f31d3518f3ecb38660c95715dfead60f"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dflydev%2Fdflydev-dot-access-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dflydev%2Fdflydev-dot-access-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dflydev%2Fdflydev-dot-access-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dflydev%2Fdflydev-dot-access-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dflydev","download_url":"https://codeload.github.com/dflydev/dflydev-dot-access-data/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254043221,"owners_count":22004912,"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":[],"created_at":"2024-11-27T16:18:37.363Z","updated_at":"2025-05-14T11:10:59.642Z","avatar_url":"https://github.com/dflydev.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Dot Access Data\n===============\n\n[![Latest Version](https://img.shields.io/packagist/v/dflydev/dot-access-data.svg?style=flat-square)](https://packagist.org/packages/dflydev/dot-access-data)\n[![Total Downloads](https://img.shields.io/packagist/dt/dflydev/dot-access-data.svg?style=flat-square)](https://packagist.org/packages/dflydev/dot-access-data)\n[![Software License](https://img.shields.io/badge/License-MIT-brightgreen.svg?style=flat-square)](LICENSE)\n[![Build Status](https://img.shields.io/github/workflow/status/dflydev/dflydev-dot-access-data/Tests/main.svg?style=flat-square)](https://github.com/dflydev/dflydev-dot-access-data/actions?query=workflow%3ATests+branch%3Amain)\n[![Coverage Status](https://img.shields.io/scrutinizer/coverage/g/dflydev/dflydev-dot-access-data.svg?style=flat-square)](https://scrutinizer-ci.com/g/dflydev/dflydev-dot-access-data/code-structure/)\n[![Quality Score](https://img.shields.io/scrutinizer/g/dflydev/dflydev-dot-access-data.svg?style=flat-square)](https://scrutinizer-ci.com/g/dflydev/dflydev-dot-access-data)\n\nGiven a deep data structure, access data by dot notation.\n\n\nRequirements\n------------\n\n * PHP (7.1+)\n\n\u003e For PHP (5.3+) please refer to version `1.0`.\n\n\nUsage\n-----\n\nAbstract example:\n\n```php\nuse Dflydev\\DotAccessData\\Data;\n\n$data = new Data;\n\n$data-\u003eset('a.b.c', 'C');\n$data-\u003eset('a.b.d', 'D1');\n$data-\u003eappend('a.b.d', 'D2');\n$data-\u003eset('a.b.e', ['E0', 'E1', 'E2']);\n\n// C\n$data-\u003eget('a.b.c');\n\n// ['D1', 'D2']\n$data-\u003eget('a.b.d');\n\n// ['E0', 'E1', 'E2']\n$data-\u003eget('a.b.e');\n\n// true\n$data-\u003ehas('a.b.c');\n\n// false\n$data-\u003ehas('a.b.d.j');\n\n\n// 'some-default-value'\n$data-\u003eget('some.path.that.does.not.exist', 'some-default-value');\n\n// throws a MissingPathException because no default was given\n$data-\u003eget('some.path.that.does.not.exist');\n```\n\nA more concrete example:\n\n```php\nuse Dflydev\\DotAccessData\\Data;\n\n$data = new Data([\n    'hosts' =\u003e [\n        'hewey' =\u003e [\n            'username' =\u003e 'hman',\n            'password' =\u003e 'HPASS',\n            'roles'    =\u003e ['web'],\n        ],\n        'dewey' =\u003e [\n            'username' =\u003e 'dman',\n            'password' =\u003e 'D---S',\n            'roles'    =\u003e ['web', 'db'],\n            'nick'     =\u003e 'dewey dman',\n        ],\n        'lewey' =\u003e [\n            'username' =\u003e 'lman',\n            'password' =\u003e 'LP@$$',\n            'roles'    =\u003e ['db'],\n        ],\n    ],\n]);\n\n// hman\n$username = $data-\u003eget('hosts.hewey.username');\n// HPASS\n$password = $data-\u003eget('hosts.hewey.password');\n// ['web']\n$roles = $data-\u003eget('hosts.hewey.roles');\n// dewey dman\n$nick = $data-\u003eget('hosts.dewey.nick');\n// Unknown\n$nick = $data-\u003eget('hosts.lewey.nick', 'Unknown');\n\n// DataInterface instance\n$dewey = $data-\u003egetData('hosts.dewey');\n// dman\n$username = $dewey-\u003eget('username');\n// D---S\n$password = $dewey-\u003eget('password');\n// ['web', 'db']\n$roles = $dewey-\u003eget('roles');\n\n// No more lewey\n$data-\u003eremove('hosts.lewey');\n\n// Add DB to hewey's roles\n$data-\u003eappend('hosts.hewey.roles', 'db');\n\n$data-\u003eset('hosts.april', [\n    'username' =\u003e 'aman',\n    'password' =\u003e '@---S',\n    'roles'    =\u003e ['web'],\n]);\n\n// Check if a key exists (true to this case)\n$hasKey = $data-\u003ehas('hosts.dewey.username');\n```\n\n`Data` may be used as an array, since it implements `ArrayAccess` interface:\n\n```php\n// Get\n$data-\u003eget('name') === $data['name']; // true\n\n$data['name'] = 'Dewey';\n// is equivalent to\n$data-\u003eset($name, 'Dewey');\n\nisset($data['name']) === $data-\u003ehas('name');\n\n// Remove key\nunset($data['name']);\n```\n\n`/` can also be used as a path delimiter:\n\n```php\n$data-\u003eset('a/b/c', 'd');\necho $data-\u003eget('a/b/c'); // \"d\"\n\n$data-\u003eget('a/b/c') === $data-\u003eget('a.b.c'); // true\n```\n\nLicense\n-------\n\nThis library is licensed under the MIT License - see the LICENSE file\nfor details.\n\n\nCommunity\n---------\n\nIf you have questions or want to help out, join us in the\n[#dflydev](irc://irc.freenode.net/#dflydev) channel on irc.freenode.net.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdflydev%2Fdflydev-dot-access-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdflydev%2Fdflydev-dot-access-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdflydev%2Fdflydev-dot-access-data/lists"}