{"id":22314372,"url":"https://github.com/undercloud/lang","last_synced_at":"2025-03-26T02:46:05.704Z","repository":{"id":57075258,"uuid":"49381200","full_name":"undercloud/lang","owner":"undercloud","description":null,"archived":false,"fork":false,"pushed_at":"2016-04-13T19:37:50.000Z","size":5,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-31T00:18:19.163Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/undercloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-10T19:13:12.000Z","updated_at":"2016-07-05T18:07:37.000Z","dependencies_parsed_at":"2022-08-24T14:55:41.472Z","dependency_job_id":null,"html_url":"https://github.com/undercloud/lang","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undercloud%2Flang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undercloud%2Flang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undercloud%2Flang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undercloud%2Flang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/undercloud","download_url":"https://codeload.github.com/undercloud/lang/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245579582,"owners_count":20638676,"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-12-03T22:09:52.973Z","updated_at":"2025-03-26T02:46:05.686Z","avatar_url":"https://github.com/undercloud.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"#Lang\nPHP Multilanguage System\n\n##install\n`composer require undercloud/lang`\n\n##translates\n```PHP\n// /en/message.php\nreturn [\n\t'hello' =\u003e 'Hello, :username',\n\t'hobbies' =\u003e 'Your hobbies is: :hobbies'\n];\n```\n\n##setup\n```PHP\nrequire 'vendor/autoload.php';\n\n$lang = new Undercloud\\Lang([\n\t// translates path\n\t'root' =\u003e '/path/to/translates',\n\t// list of user accepted, default parse http header Accept-Language\n\t'accept' =\u003e ['en', 'de'],\n\t// list of supported translates\n\t'avail' =\u003e ['en','fr','de'],\n\t// setup translates file handler, default PHP Arrays\n\t'parser' =\u003e new Undercloud\\Lang\\Parser\\AbstractParser\n]);\n\n// Hello, John\n$lang('message.hello', ['username' =\u003e 'John']);\n\n//Your hobbies is: music, football, web\n$lang('message.hobbies', ['hobbies': ['music', 'football', 'web']]);\n```\n\n##api\n```PHP\n// parse Accept-Language header and return supported locales\n$lang-\u003egetLangsHttp();\n\n// return primary locale name\n$lang-\u003egetPrimaryLocale();\n\n// return fallback locale\n$lang-\u003egetFallBackLocale();\n```\n\n##parser\nBy default avail two type of language files parsers `Undercloud\\Lang\\Parser\\DefaultParser` and `Undercloud\\Lang\\Parser\\JsonParser`,\nYou can define you'r own parser:\n```PHP\n// file based parser\nuse Undercloud\\Lang\\Parser\\AbstractParser;\n\nclass MyOwnParser extends AbstractParser\n{\n\tpublic function parse()\n\t{\n\t\t$path = func_get_arg(0) . '.extension';\n\t\t/*...*/\n\t}\n}\n```\nor\n```PHP\n// database like parser\nuse Undercloud\\Lang\\Parser\\AbstractParser;\n\nclass MyOwnParser extends AbstractParser\n{\n\tpublic $buildPath = false;\n\n\tpublic function parse()\n\t{\n\t\t$locale = func_get_arg(0);\n\t\t$entity = func_get_arg(1);\n\n\t\t/*...*/\n\t}\n}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundercloud%2Flang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fundercloud%2Flang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundercloud%2Flang/lists"}