Download the PHP package quangtam/vietnam-address-converter without Composer
On this page you can find all versions of the php package quangtam/vietnam-address-converter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
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 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.
Informations about the package vietnam-address-converter
Vietnam Address Converter PHP
Thư viện PHP để tự động chuyển đổi địa chỉ hành chính Việt Nam từ cũ sang mới theo Nghị quyết số 202/2025/QH15 của Quốc hội.
🌐 Multi-Language Support
Vietnam Address Converter hiện có sẵn cho nhiều ngôn ngữ lập trình:
- 🟨 JavaScript/TypeScript: vietnam-address-converter
- 🟦 PHP: vietnam-address-converter-php - Thư viện PHP với API tương tự (repo này)
- 🔴 Python: Coming soon...
- 🟩 Go: Coming soon...
💡 Tất cả implementations đều sử dụng cùng dữ liệu mapping và logic chuyển đổi để đảm bảo tính nhất quán.
✨ Tính năng chính
- 🔄 Chuyển đổi địa chỉ tự động: Chuyển đổi địa chỉ cũ sang địa chỉ mới theo quy định mới nhất
- 📊 Dữ liệu mapping thực tế: Sử dụng dữ liệu mapping chính thức từ cơ sở dữ liệu hành chính
- 🎯 Cấu trúc hành chính mới: Loại bỏ cấp quận/huyện theo Nghị quyết 202/2025/QH15
- 🔍 Tìm kiếm thông minh: Tìm kiếm và mapping địa chỉ với độ chính xác cao
- ⚡ Hiệu suất cao: Xử lý nhanh với caching tối ưu
- 📱 Dễ sử dụng: API đơn giản và dễ tích hợp
📈 Thay đổi quan trọng
Loại bỏ cấp Quận/Huyện
Theo Nghị quyết 202/2025/QH15, cấu trúc hành chính mới không còn cấp quận/huyện:
Trước (3 cấp):
Sau (2 cấp):
Ví dụ chuyển đổi:
Input:
Output:
🚀 Cài đặt
Yêu cầu hệ thống
- PHP >= 8.0
- Extension: json
Cài đặt qua Composer
Database sẽ được tự động tải từ package quangtam/vietnam-address-database
Cài đặt thủ công
-
Clone repository:
- Cài đặt dependencies:
🔧 Sử dụng cơ bản
1. Khởi tạo Converter
2. Chuyển đổi địa chỉ từ string
3. Chuyển đổi từ object
4. Xuất kết quả dưới dạng JSON
🔄 Các loại chuyển đổi
1. Merged (Gộp)
Nhiều phường/xã cũ được gộp thành một phường/xã mới:
2. Renamed (Đổi tên)
Phường/xã giữ nguyên ranh giới nhưng đổi tên:
3. Unchanged (Không đổi)
Phường/xã không có thay đổi:
📊 API Reference
VietnamAddressConverter
initialize(): void
Khởi tạo converter với dữ liệu từ Vietnam Address Database package.
convertAddress(string|FullAddress $address): ConversionResult
Chuyển đổi địa chỉ từ định dạng cũ sang mới.
Tham số:
$address: Địa chỉ cần chuyển đổi (string hoặc FullAddress object)
Kết quả trả về:
ConversionResult: Kết quả chuyển đổi
getDataStats(): array
Lấy thống kê dữ liệu.
getProvinces(): array
Lấy danh sách tất cả tỉnh/thành phố.
getWardsByProvince(string $provinceCode): array
Lấy danh sách phường/xã theo mã tỉnh.
searchMappings(string $keyword): array
Tìm kiếm mapping theo từ khóa.
Models
ConversionResult
FullAddress (Địa chỉ cũ có district)
NewAddress (Địa chỉ mới không có district)
💻 Ví dụ hoàn chỉnh
📊 Dữ liệu
Thư viện sử dụng package quangtam/vietnam-address-database bao gồm:
- 34 tỉnh/thành phố theo cấu trúc hành chính mới
- 3,321 phường/xã đã được cập nhật
- 10,977 mapping records cho việc chuyển đổi
Dữ liệu được cập nhật theo Nghị quyết số 202/2025/QH15 của Quốc hội về việc sắp xếp đơn vị hành chính và tự động đồng bộ từ database package.
🛠️ Phát triển
Chạy tests
Kiểm tra code style
Sửa code style
Chạy ví dụ
🤝 Đóng góp
Chúng tôi hoan nghênh mọi đóng góp! Vui lòng:
- Fork dự án
- Tạo feature branch (
git checkout -b feature/amazing-feature) - Commit thay đổi (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Mở Pull Request
📄 License
MIT License
📞 Liên hệ
- Issues: GitHub Issues
- Email: [email protected]
🙏 Cảm ơn
- Dữ liệu từ thanhtrungit97/dvhcvn
- Nghị quyết số 202/2025/QH15 của Quốc hội
- Tham khảo từ quangtam/vietnam-address-converter
Made with ❤️ for Vietnam developers
