Download the PHP package nguyenary/vietnam-address-api without Composer

On this page you can find all versions of the php package nguyenary/vietnam-address-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of nguyenary/vietnam-address-api

Informations about the package vietnam-address-api

Đơn Vị Hành Chính Việt Nam

Thư viện được viết bằng PHP để lấy thông tin các đơn vị hành chính Việt Nam (Tỉnh, Thành Phố, Quận, Huyện, Xã, Phường, Thị Trấn...)

Installation

Install sử dụng composer

Usage

1. Cách Update Data Đơn Vị Hành Chính Việt Nam (nếu có thay đổi)

Nếu trong tương lai dữ liệu Đơn Vị Hành Chính Việt Nam có thay đổi thông tin (Quận, Huyện, Xã, Phường..v..v) bạn có thể chủ động update lại dữ liệu bằng cách dưới đây.

Dữ liệu được xuất từ các file excel tải từ địa chỉ: https://danhmuchanhchinh.gso.gov.vn/

Cách để tải file excel

Ví dụ dưới đây là cách tải file excel đơn vị hành chính của thành phố Hà Nội

Cách để tải file excel tất cả các địa danh bằng script

Hãy copy code trong file download-script.js và truy cập vào địa chỉ trên. Nhấn Ctrl + Shift + I để mở console và paste đoạn code vào đây rồi enter kết quả sẽ như hình.

File excel được lưu trong folder excel_files

Để update dữ liệu mới cho Đơn Vị Hành Chính hãy bỏ file excel đã tải vào folder này và tiến hành chạy lệnh:

Sẽ được kết quả như sau:

Vậy là bạn đã tự update lại dữ liệu Đơn Vị Hành Chính thành công!

Hoặc bạn có thể tạo issues trong project để báo cáo vấn đề về dữ liệu đang gặp phải hoặc chủ động tạo pull requests để đóng góp bản cập nhật dữ liệu mới cho project này.


2. Cách Sử Dụng Trong Dự Án

Xem ví dụ cụ thể tham khảo file example.php

Address::getProvinces()

Lấy tất cả Tỉnh / Thành Phố của Việt Nam

  • Option:
  • province_ids (array) : Mảng chứa danh sách province_id muốn lấy

    Address::getProvince()

    Lấy thông tin của một Tỉnh, Thành Phố theo province_id

  • Require:
  • province_id (string) : province_id của Tỉnh / Thành Phố muốn lấy thông tin

    Address::getDistrictsByProvinceId()

    Lấy danh sách Quận / Huyện của một Tỉnh / Thành Phố bằng province_id

  • Require:
  • province_id (string) : province_id của Tỉnh / Thành Phố để lấy danh sách các Quận / Huyện của nó

    Address::getDistrict()

    Lấy thông tin của Quận / Huyện bằng district_id

  • Require:
  • district_id (string) : district_id của Quận / Huyện cần lấy thông tin

    Address::getWardsByDistrictId()

    Lấy danh sách Xã / Phường / Thị Trấn của một Quận / Huyện bằng district_id

  • Require:
  • district_id (string) : district_id của Quận / Huyện để lấy danh sách Xã / Phường / Thị Trấn của nó

    Address::getWard()

    Lấy thông tin Xã / Phường / Thị Trấn bằng distric_id và ward_id

  • Require:
  • district_id (string) : district_id của Quận / Huyện chứa Xã / Phường / Thị Trấn cần lấy thông tin
  • ward_id (string) : ward_id của Xã / Phường / Thị Trấn cần lấy thông tin

    Address::setSchema()

    Định dạng lại các trường sẽ trả về. Gọi hàm này trước khi gọi các phương thức get ở trên (Mặc định sẽ trả về tất cả)

  • Option:
  • schema (array) : Mảng chứa danh sách các trường cần lấy (Vd: name, type, code,...v..v)

Project này có tái sử dụng code từ: madnh/hanhchinhvn

All versions of vietnam-address-api with dependencies

PHP Build Version
Package Version
Requires php Version >=7.2
phpoffice/phpexcel Version ^1.8
symfony/var-dumper Version ^3.2
cocur/slugify Version ^2.4
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package nguyenary/vietnam-address-api contains the following files

Loading the files please wait ....