Download the PHP package puleeno/nhanh-vn-sdk without Composer

On this page you can find all versions of the php package puleeno/nhanh-vn-sdk. 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 puleeno/nhanh-vn-sdk

Informations about the package nhanh-vn-sdk

Nhanh.vn PHP SDK

PHP Version Version [Build Status]()

PHP SDK chính thức cho Nhanh.vn API - Giải pháp tiêu chuẩn để tích hợp với Nhanh.vn một cách dễ dàng và hiệu quả.

🌟 Giới thiệu

Nhanh.vn PHP SDK v0.4.0 - Thư viện PHP chính thức được phát triển để giúp các nhà phát triển tích hợp dễ dàng với Nhanh.vn API.

SDK này cung cấp giao diện đơn giản, an toàn và hiệu quả để tương tác với tất cả các dịch vụ của Nhanh.vn, được thiết kế theo kiến trúc SOLID với hệ thống cache thông minh và quản lý memory tối ưu.

✨ Version 0.4.0 Highlights:

🚀 Tính năng chính

📦 Cài đặt

Yêu cầu hệ thống

Cài đặt qua Composer

🔧 Cấu hình

Khởi tạo cấu hình cơ bản

Cách 1: Sử dụng Nhanh Client Builder (Khuyến nghị)

Cách 2: Sử dụng ClientConfig (Legacy)

📚 Ví dụ sử dụng

🔐 Xác thực OAuth

📦 Quản lý sản phẩm

// Lấy sản phẩm theo danh mục $categoryProducts = $client->products()->getByCategory(1, [ 'page' => 1, 'perPage' => 20, 'sortBy' => 'price', 'sortOrder' => 'asc' ]);

// Lấy sản phẩm nổi bật $hotProducts = $client->products()->getHot(10);

// Lấy sản phẩm mới $newProducts = $client->products()->getNew(10);

// Lấy sản phẩm trang chủ $homeProducts = $client->products()->getHome(20);

// Lấy thống kê $stats = $client->products()->getStatistics();

// Quản lý cache $cacheStatus = $client->products()->getCacheStatus(); $client->products()->clearCache();

src/ ├── Client/ # Client chính (NhanhVnClient) ├── Config/ # Cấu hình client ├── Contracts/ # Interfaces và contracts ├── Entities/ # Data entities (Product, Category, Brand, etc.) │ └── Product/ # Product-related entities │ └── Customer/ # Customer-related entities ├── Exceptions/ # Custom exceptions ├── Managers/ # Business logic managers ├── Modules/ # Feature modules (ProductModule, CustomerModule) ├── Repositories/ # Data access layer └── Services/ # Business services

tests/ # Unit tests và integration tests examples/ # Ví dụ sử dụng docs/ # Tài liệu API chi tiết

Module/ ├── Entity/ # Data models ├── Repository/ # Data access ├── Service/ # Business logic ├── Manager/ # Orchestration └── Module/ # Public interface bash

Chạy tất cả tests

composer test

Chạy tests với coverage

composer test-coverage

Kiểm tra code style

composer cs-check

Tự động fix code style

composer cs-fix

Static analysis

composer stan



## 📖 Tài liệu

- [🚀 Nhanh Client Builder - Quick Start](docs/client-builder-quickstart.md)
- [📚 Nhanh Client Builder - Hướng dẫn chi tiết](docs/client-builder.md)
- [API Reference](docs/api-reference.md)
- [Authentication](docs/authentication.md)
- [Error Handling](docs/error-handling.md)
- [Best Practices](docs/best-practices.md)
- [Migration Guide](docs/migration-guide.md)

## 📋 Changelog

### Version 0.4.0 (2024-12-19)
**🚀 Major Release - Order & Shipping Modules**

#### ✨ New Features
- **Order Module hoàn chỉnh**: Quản lý đơn hàng toàn diện với 15+ methods
- **Shipping Module mới**: Hỗ trợ địa điểm 3 cấp (Thành phố, Quận huyện, Phường xã)
- **Cache System nâng cao**: Tối ưu hiệu suất API với TTL thông minh
- **Memory Management**: Tự động cleanup và tối ưu memory usage

#### 🔧 Improvements
- **Chuẩn hóa toàn bộ**: Theo style ProductModule với SOLID principles
- **Validation System**: Hỗ trợ tiếng Việt với thông báo lỗi chi tiết
- **Error Handling**: Xử lý lỗi thông minh với fallback strategies
- **Logging System**: Ghi log chi tiết cho debugging và monitoring

#### 🐛 Bug Fixes
- Sửa lỗi method `prepareSearchCriteria()` trong OrderModule
- Cải thiện error handling trong Shipping entities
- Tối ưu memory usage trong batch operations

#### 📚 Documentation
- Cập nhật API documentation cho Order & Shipping
- Thêm examples cho tất cả modules
- Cải thiện README với roadmap chi tiết

### Version 0.3.0 (2024-11-15)
- Product Module hoàn chỉnh
- Customer Module cơ bản
- OAuth 2.0 authentication

### Version 0.2.0 (2024-10-01)
- Core architecture implementation
- Basic HTTP service
- Configuration management

### Version 0.1.0 (2024-09-01)
- Initial project setup
- Basic structure
- Development environment

## 🤝 Đóng góp

Chúng tôi rất hoan nghênh mọi đóng góp! Vui lòng đọc [CONTRIBUTING.md](CONTRIBUTING.md) để biết thêm chi tiết.

## 📄 License

Dự án này được cấp phép theo [MIT License](LICENSE).

## 🗺️ Roadmap & Kế hoạch phát triển

### ✅ Version 0.4.0 (Q4 2024) - Hoàn thiện Core & Shipping
- 🚀 **Order Module** - 100% hoàn thành với đầy đủ tính năng
- 🗺️ **Shipping Module** - 100% hoàn thành với địa điểm 3 cấp
- 🔧 **Chuẩn hóa toàn bộ** - Theo style ProductModule
- 💾 **Cache system** - Tối ưu hiệu suất và memory management

### 🎯 Version 0.5.0 (Q1 2025) - Business Modules
- 📦 **Bill Module** - Xuất nhập kho, quản lý tồn kho
- 🏪 **Store Module** - Kho hàng, nhân viên, chi nhánh
- 📊 **Statistics Module** - Báo cáo, thống kê

### 🎯 Version 0.6.0 (Q2 2025) - Advanced Features
- 🔔 **Webhooks Module** - Event handling, real-time updates
- 🎉 **Promotion Module** - Khuyến mãi, mã giảm giá
- 💰 **Accounting Module** - Kế toán, tài chính

### 🎯 Version 0.7.0 (Q3 2025) - Integration & AI
- 📱 **Zalo Module** - Gửi tin ZNS, chatbot
- 🛒 **Ecommerce Module** - Gian hàng, marketplace
- 🤖 **AI Integration** - Phân tích dữ liệu thông minh

### 🎯 Version 1.0.0 (Q4 2025) - Production Ready
- 🚀 **Performance optimization** - Tối ưu hóa toàn diện
- 🔒 **Security hardening** - Bảo mật nâng cao
- 📚 **Documentation** - Tài liệu đầy đủ và examples

## 🆘 Hỗ trợ

**Hỗ trợ chính thức:**
- **Documentation**: [GitHub Repository](https://github.com/puleeno/nhanh-vn-sdk)
- **Issues**: [GitHub Issues](https://github.com/puleeno/nhanh-vn-sdk/issues)
- **Email**: [email protected]

**Dịch vụ gia công chuyên nghiệp:**
- 🔧 **Plugin development** - Phát triển plugin tùy chỉnh
- 💻 **Software integration** - Đồng bộ dữ liệu với Nhanh.vn
- 🚀 **Custom solutions** - Giải pháp tích hợp theo yêu cầu

**Liên hệ thuê gia công:**
- 📞 **Hotline**: 0981272899
- 📧 **Email**: [email protected]
- 💼 **Chuyên môn**: PHP, Laravel, WordPress, WooCommerce, Nhanh.vn API

All versions of nhanh-vn-sdk with dependencies

PHP Build Version
Package Version
Requires php Version >=8.1
guzzlehttp/guzzle Version ^7.0
nesbot/carbon Version ^2.0
illuminate/collections Version ^10.0
monolog/monolog Version ^3.0
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 puleeno/nhanh-vn-sdk contains the following files

Loading the files please wait ....