PHPackages diepxuan/laravel-simba - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. diepxuan/laravel-simba ActiveLibrary[Framework](/categories/framework) diepxuan/laravel-simba ====================== Laravel Integration With Simba 1.0.2(5d ago)062.5k↓90.6%[2 PRs](https://github.com/diepxuan/laravel-simba/pulls)1MITPHP Since Feb 22Pushed 5d ago1 watchersCompare [ Source](https://github.com/diepxuan/laravel-simba)[ Packagist](https://packagist.org/packages/diepxuan/laravel-simba)[ RSS](/packages/diepxuan-laravel-simba/feed)WikiDiscussions main Synced today READMEChangelogDependencies (12)Versions (21)Used By (1) Laravel Simba ============= [](#laravel-simba) Tích hợp Laravel với Simba (phần mềm kế toán). 📚 Documentation --------------- [](#-documentation) - **Project Docs:** [Model Architecture](../../docs/project/model-architecture.md) - 3-layer Model pattern (SModel → Simba\\Models → Catalog\\Models) - **Project Docs:** [Package Namespace Conventions](../../docs/project/package-namespace-conventions.md) Mô tả ngắn gọn -------------- [](#mô-tả-ngắn-gọn) Laravel Integration With Simba. Package cung cấp các model và stored procedure caller để tương tác với cơ sở dữ liệu Simba (ERP/kế toán), hỗ trợ composite primary key và xử lý charset. > ⚠️ **NGUYÊN TẮC BẤT BIẾN:** Package chỉ hỗ trợ **READ** trực tiếp qua Models. Mọi thao tác **INSERT/UPDATE/DELETE** phải thực hiện thông qua **Stored Procedures**. Không thao tác trực tiếp trên bảng. Xem chi tiết: [Database Access Policy](./docs/DATABASE_ACCESS_POLICY.md) Kiến trúc Model 3 lớp --------------------- [](#kiến-trúc-model-3-lớp) Package sử dụng kiến trúc Model 3 lớp để phân chia trách nhiệm rõ ràng: ``` Diepxuan\Catalog\Models\ extends Diepxuan\Simba\Models\ extends Diepxuan\Simba\SModel\Model ``` **Xem chi tiết:** [Model Architecture](./docs/MODEL-ARCHITECTURE.md) Chức năng chính --------------- [](#chức-năng-chính) - Cung cấp các model (SModel) tương ứng với các bảng dữ liệu trong hệ thống Simba: SysLanguage, InCT3, SoPh3, GlDmTk, GlCt, GlCdTk, SysCompany, SysCompanyResx, InDmVt, InPH3, SiSetup, SysUserCompanyRight, ArDmKh, InDmKho, SysUserInfo, InDmNhvt, ... - Cung cấp các stored procedure caller để gọi procedure từ Simba: AsGetSoCt, AsGetSoDuKh, và class ProcedureCaller tổng quát. - Sử dụng composite primary key (từ package eloquent-composite). - Phụ thuộc vào package charset để xử lý encoding. - Cấu hình kết nối database riêng (mặc định sqlsrv) qua environment variable `SIMBA_CONNECTION`. Cài đặt / Sử dụng ----------------- [](#cài-đặt--sử-dụng) ``` composer require diepxuan/laravel-simba ``` Package không có ServiceProvider, cần sử dụng thủ công. Cấu hình kết nối database Simba trong `.env`: ``` SIMBA_CONNECTION=sqlsrv DB_CONNECTION_SIMBA=... (nếu dùng connection riêng) ``` Sử dụng model: ``` use Diepxuan\Simba\SModel\InDmVtModel; $items = InDmVtModel::all(); ``` Sử dụng stored procedure caller: ``` use Diepxuan\Simba\StoredProcedures\ProcedureCaller; $result = ProcedureCaller::call('asGetSoCt', ['pMa_Cty' => '01', 'pNgay_Ct' => '2024-01-01']); ``` Hoặc dùng class cụ thể: ``` use Diepxuan\Simba\StoredProcedures\AsGetSoCt; $result = AsGetSoCt::call($params); ``` Cấu trúc thư mục ---------------- [](#cấu-trúc-thư-mục) ``` laravel-simba/ ├── config/ │ └── config.php # Cấu hình package (connection) ├── src/ │ ├── SModel/ # Raw/table schema của SimbaERP (1:1 với bảng vật lý) │ │ ├── SModel.php (base) │ │ └── *Model.php # Mỗi file tương ứng một bảng, tên theo chuẩn Model │ ├── Models/ # Model Simba có behavior/query helper trực tiếp dùng trong code │ │ └── .php # Extend từ Model tương ứng ở SModel │ ├── StoredProcedures/ # Các class gọi stored procedure │ │ ├── ProcedureCaller.php │ │ ├── AsGetSoCt.php │ │ └── AsGetSoDuKh.php │ └── Database/ (factories, seeders - chưa có nội dung) ├── .editorconfig ├── .gitignore ├── .php-cs-fixer.dist.php ├── LICENSE ├── README.md └── composer.json ``` Liên kết đến các package liên quan ---------------------------------- [](#liên-kết-đến-các-package-liên-quan) - diepxuan/php-charset (xử lý charset) - diepxuan/laravel-core (core chung) - diepxuan/laravel-eloquent-composite (hỗ trợ composite primary key) - diepxuan/laravel-catalog (package sử dụng chính) Tài liệu -------- [](#tài-liệu) - [Model Architecture](docs/MODEL-ARCHITECTURE.md) - Kiến trúc Model 3 lớp - [Configuration](docs/CONFIGURATION.md) - Cấu hình package - [Database Access Policy](docs/DATABASE_ACCESS_POLICY.md) - Chính sách truy cập database - [Stored Procedures](docs/README.md) - Danh sách stored procedures - [Troubleshooting](docs/TROUBLESHOOTING.md) - Xử lý sự cố Ghi chú ------- [](#ghi-chú) Package này tích hợp với cơ sở dữ liệu Simba, phục vụ cho việc trao đổi dữ liệu giữa Laravel và hệ thống ERP Simba (phần mềm kế toán). Cần cấu hình kết nối SQL Server (sqlsrv) đúng với database Simba. ### Health Score 48 — FairBetter than 93% of packages Maintenance99 Actively maintained with recent releases Popularity26 Limited adoption so far Community13 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~7 days Total 18 Last Release 5d ago Major Versions 0.9.2 → 1.0.02026-06-22 ### Community Maintainers ![](https://www.gravatar.com/avatar/90fcb59bfa8097c0e0dacd05f43901adb774dc4adb6172b2b743635f8f3d1d2e?d=identicon)[caothu159](/maintainers/caothu159) --- Top Contributors [![caothu159](https://avatars.githubusercontent.com/u/4988663?v=4)](https://github.com/caothu159 "caothu159 (132 commits)") ### Embed Badge ![Health badge](/badges/diepxuan-laravel-simba/health.svg) ``` [![Health](https://phpackages.com/badges/diepxuan-laravel-simba/health.svg)](https://phpackages.com/packages/diepxuan-laravel-simba) ``` ### Alternatives [laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k39.6M297](/packages/laravel-dusk)[nineinchnick/edatatables Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin 173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf LinkCloud Fast Hyperf 241.2k1](/packages/link-cloud-fast-hyperf) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)