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 0.7.1(1mo ago)062.4k↓25%[2 PRs](https://github.com/diepxuan/laravel-simba/pulls)1MITPHP Since Feb 22Pushed 1mo 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 1mo ago READMEChangelogDependencies (6)Versions (14)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\InDmVt; $items = InDmVt::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/ # Các model Simba (bảng dữ liệu) │ │ ├── SModel.php (base) │ │ ├── SysLanguage.php │ │ ├── InCT3.php │ │ ├── SoPh3.php │ │ ├── GlDmTk.php │ │ ├── GlCt.php │ │ ├── GlCdTk.php │ │ ├── SysCompany.php │ │ ├── SysCompanyResx.php │ │ ├── InDmVt.php │ │ ├── InPH3.php │ │ ├── SiSetup.php │ │ ├── SysUserCompanyRight.php │ │ ├── ArDmKh.php │ │ ├── InDmKho.php │ │ ├── SysUserInfo.php │ │ └── InDmNhvt.php │ ├── Models/ # Các model mở rộng (có thể thêm scope) │ │ ├── SysCompany.php │ │ ├── SysUserCompanyRight.php │ │ ├── InDmVt.php │ │ ├── InDmKho.php │ │ ├── SysUserInfo.php │ │ ├── ArDmKh.php │ │ ├── SoPh3.php │ │ ├── InDmNhvt.php │ │ ├── SiSetup.php │ │ └── GlCt.php │ ├── 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 40 — FairBetter than 88% of packages Maintenance89 Actively maintained with recent releases Popularity24 Limited adoption so far Community11 Small or concentrated contributor base Maturity31 Early-stage or recently created project 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 ~3 days Total 11 Last Release 54d ago ### 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 (98 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/passport Laravel Passport provides OAuth2 server support to Laravel. 3.4k85.0M532](/packages/laravel-passport)[nolimits4web/swiper Most modern mobile touch slider and framework with hardware accelerated transitions 41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k36.7M259](/packages/laravel-dusk)[laravel/prompts Add beautiful and user-friendly forms to your command-line applications. 712181.8M596](/packages/laravel-prompts)[cakephp/chronos A simple API extension for DateTime. 1.4k47.7M121](/packages/cakephp-chronos)[laravel/pail Easily delve into your Laravel application's log files directly from the command line. 91545.3M590](/packages/laravel-pail) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)