{"id":34789970,"url":"https://github.com/dakalab/division-code","last_synced_at":"2026-05-16T16:05:38.419Z","repository":{"id":56961508,"uuid":"158532073","full_name":"dakalab/division-code","owner":"dakalab","description":"Administrative division codes of China (http://www.mca.gov.cn/article/sj/xzqh/)","archived":false,"fork":false,"pushed_at":"2021-01-05T09:03:06.000Z","size":692,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-29T11:23:22.796Z","etag":null,"topics":["city","county","division","province"],"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/dakalab.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-11-21T10:38:31.000Z","updated_at":"2021-01-05T08:46:29.000Z","dependencies_parsed_at":"2022-08-21T09:20:43.811Z","dependency_job_id":null,"html_url":"https://github.com/dakalab/division-code","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/dakalab/division-code","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dakalab%2Fdivision-code","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dakalab%2Fdivision-code/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dakalab%2Fdivision-code/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dakalab%2Fdivision-code/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dakalab","download_url":"https://codeload.github.com/dakalab/division-code/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dakalab%2Fdivision-code/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33109461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["city","county","division","province"],"created_at":"2025-12-25T09:58:01.522Z","updated_at":"2026-05-16T16:05:38.414Z","avatar_url":"https://github.com/dakalab.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# division code\n\n[![Build Status](https://travis-ci.org/dakalab/division-code.svg?branch=master)](https://travis-ci.org/dakalab/division-code)\n[![Codecov](https://codecov.io/gh/dakalab/division-code/branch/master/graph/badge.svg)](https://codecov.io/gh/dakalab/division-code)\n[![Latest Stable Version](https://poser.pugx.org/dakalab/division-code/v/stable)](https://packagist.org/packages/dakalab/division-code)\n[![Total Downloads](https://poser.pugx.org/dakalab/division-code/downloads)](https://packagist.org/packages/dakalab/division-code)\n[![License](https://poser.pugx.org/dakalab/division-code/license.svg)](https://packagist.org/packages/dakalab/division-code)\n\nAdministrative division codes of China (http://www.mca.gov.cn/article/sj/xzqh/)\n\nThis library has two ways of storage: php array file and SQLite3 database, see the benchmark below. The library will automatically detect if your php support SQLite3, if yes then it will use SQLite3, otherwise it will fall back to use php array.\n\nYou can also use function `useSQLite($v = true)` to turn on or turn off using SQLite.\n\n## Install\n\n```\ncomposer require dakalab/division-code\n```\n\n## Usage\n\n```\nuse Dakalab\\DivisionCode\\DivisionCode;\n\n$divisionCode = new DivisionCode;\n$res = $divisionCode-\u003eget('110000'); // 北京市\n\n// Get all the provinces\n$provinces = $divisionCode-\u003egetAllProvinces();\nprint_r($provinces);\n\n// Get all the cities in the specified province\n$province = '110000';\n$cities = $divisionCode-\u003egetCitiesInProvince($province);\nprint_r($cities);\n\n// Get all the counties in the specified city\n$city = '445200';\n$counties = $divisionCode-\u003egetCountiesInCity($city);\nprint_r($counties);\n\n// Get all the cities in the specified province by the province name\n$province = '广东省';\n$cities = $divisionCode-\u003egetCitiesByProvinceName($province);\nprint_r($cities);\n```\n\n## Upgrade\n\nIf you want to upgrade the division codes by yourself, you can simply run the `Upgrader`\n\n```\nuse Dakalab\\DivisionCode\\Upgrader;\n\n$upgrader = new Upgrader;\n$upgrader-\u003eupgrade();\n```\n\n## Benchmark\n\nFor a loop of 1000000 calls ran on a MacBook Pro 2.9 GHz Intel Core i5, 8GB 1867 MHz DDR3:\n\n**Use sqlite3**\n\nTime cost: 23.28 s, Memory cost: 15.85 kb\n\n**Use php array**\n\nTime cost: 0.47 s, Memory cost: 287.45 kb\n\n**Conclusion**\n\nSQLite3 uses less memory usage but slower, built-in php array is much faster but costs much more memory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdakalab%2Fdivision-code","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdakalab%2Fdivision-code","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdakalab%2Fdivision-code/lists"}