PHPackages mecxer713/wialon-package - 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. [API Development](/categories/api) 4. / 5. mecxer713/wialon-package ActiveLibrary[API Development](/categories/api) mecxer713/wialon-package ======================== Laravel and Symfony SDK for the Wialon (Gurtam) API: auto authentication, facade, simplified calls, and local SSL handling. 02PHPCI failing Since Feb 5Pushed 3mo agoCompare [ Source](https://github.com/Mecxer713/wialon-package)[ Packagist](https://packagist.org/packages/mecxer713/wialon-package)[ RSS](/packages/mecxer713-wialon-package/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Wialon SDK for Laravel & Symfony ==================================== [](#wialon-sdk-for-laravel--symfony) > ๐Ÿš€ A **developer-first**, production-ready SDK to integrate the **Wialon (Gurtam) API** into Laravel & Symfony โ€” with zero-auth pain, zero-SSL pain, and a clean architecture youโ€™ll actually enjoy using. --- ๐Ÿ“š Table of Contents ------------------- [](#-table-of-contents) - [Wialon SDK for Laravel & Symfony](#wialon-sdk-for-laravel--symfony) - [๐Ÿ“š Table of Contents](#-table-of-contents) - [Overview](#overview) - [โœจ Key Highlights](#-key-highlights) - [๐Ÿ“ฆ Package Identity](#-package-identity) - [2๏ธโƒฃ Laravel Integration Layer](#2%EF%B8%8F%E2%83%A3-laravel-integration-layer) - [3๏ธโƒฃ Symfony Integration Layer](#3%EF%B8%8F%E2%83%A3-symfony-integration-layer) - [๐Ÿ“ฅ Installation](#-installation) - [Laravel](#laravel) - [Symfony](#symfony) - [โš™๏ธ Configuration](#%EF%B8%8F-configuration) - [Environment variables](#environment-variables) - [๐Ÿš€ Quick Usage](#-quick-usage) - [Laravel (Facade)](#laravel-facade) - [Symfony (Dependency Injection)](#symfony-dependency-injection) - [๐ŸŒ Generic API Calls](#-generic-api-calls) - [๐Ÿ” GET vs POST](#-get-vs-post) - [๐Ÿ” SSL & Certificate Handling (Killer Feature)](#-ssl--certificate-handling-killer-feature) - [Automatic Fix](#automatic-fix) - [๐Ÿงช Error Handling](#-error-handling) - [โœ… Tests](#-tests) - [๐Ÿ“Œ Why This Package?](#-why-this-package) - [๐Ÿ“œ License](#-license) --- Overview -------- [](#overview) **Wialon SDK for Laravel & Symfony** is a modern, open-source PHP SDK designed to make Wialon API integration **simple, reliable, and enjoyable**. It abstracts away the two biggest pain points developers face when working with Wialon: - ๐Ÿ” **Session management (SID)** โ€” handled automatically, transparently, and safely - ๐Ÿ”’ **SSL & cURL certificate errors** โ€” fixed out of the box, even on Windows Built around a **pure PHP core** and wrapped with **native Laravel & Symfony integrations**, this package lets you focus on business logic instead of boilerplate, edge cases, and environment issues. Whether you are building a **fleet management system**, an **internal dashboard**, or a **production SaaS**, this SDK is designed to scale with confidence. --- โœจ Key Highlights ---------------- [](#-key-highlights) - ๐Ÿ” **Zero-config authentication**: automatic session (`sid`) lifecycle management - ๐Ÿง  **Pure PHP core**: reusable, testable, framework-independent logic - ๐Ÿงฉ **Native integrations**: - Laravel Facade & Artisan command - Symfony Bundle, DI & Console command - ๐Ÿ›  **Built-in SSL fixer**: automatic CA certificate download (cURL 60/77) - ๐Ÿš€ **Developer Experience (DX) focused** --- ๐Ÿ“ฆ Package Identity ------------------ [](#-package-identity) - **Name**: `mecxer713/wialon-package` - **Type**: Hybrid SDK (Laravel & Symfony) - **Core dependencies**: - `guzzlehttp/guzzle` - `illuminate/support` (Laravel) - `symfony/http-kernel` (Symfony) - **Compatibility**: - Laravel **10, 11, 12** - Symfony **6, 7** --- ### 2๏ธโƒฃ Laravel Integration Layer [](#2๏ธโƒฃ-laravel-integration-layer) Designed to feel 100% native to Laravel developers. Components: - `WialonServiceProvider` โ€“ container binding & config publishing - `Facades/Wialon.php` โ€“ static access (`Wialon::call()`) - `Commands/TestWialonConnection.php` โ€“ Artisan diagnostic command - `config/wialon.php` โ€“ Laravel configuration --- ### 3๏ธโƒฃ Symfony Integration Layer [](#3๏ธโƒฃ-symfony-integration-layer) Delivered as a standard Symfony Bundle. Components: - `WialonBundle.php` โ€“ bundle entry point - `DependencyInjection/WialonExtension.php` โ€“ service injection - `DependencyInjection/Configuration.php` โ€“ YAML config validation - `Commands/WialonCheckCommand.php` โ€“ Console diagnostic command --- ๐Ÿ“ฅ Installation -------------- [](#-installation) ``` composer require mecxer713/wialon-package ``` ### Laravel [](#laravel) ``` php artisan vendor:publish --tag=wialon-config ``` ### Symfony [](#symfony) Enable the bundle (if not using Flex auto-discovery): ``` // config/bundles.php Mecxer\WialonPackage\WialonBundle::class => ['all' => true], ``` --- โš™๏ธ Configuration ---------------- [](#๏ธ-configuration) ### Environment variables [](#environment-variables) ``` WIALON_TOKEN=your_token_here WIALON_BASE_URL=https://hst-api.wialon.com/wialon/ajax.html WIALON_DEFAULT_METHOD=POST ``` - Laravel: `config/wialon.php` - Symfony: `config/packages/wialon.yaml` --- ๐Ÿš€ Quick Usage ------------- [](#-quick-usage) ### Laravel (Facade) [](#laravel-facade) ``` use Mecxer\WialonPackage\Facades\Wialon; Wialon::login(); $units = Wialon::getUnits(); ``` ### Symfony (Dependency Injection) [](#symfony-dependency-injection) ``` use Mecxer\WialonPackage\WialonClient; public function index(WialonClient $wialon) { $units = $wialon->getUnits(); } ``` --- ๐ŸŒ Generic API Calls ------------------- [](#-generic-api-calls) ``` Wialon::call('core/search_items', [ 'spec' => [ 'itemsType' => 'avl_unit', 'propName' => 'sys_name', 'propValueMask' => '*', 'sortType' => 'sys_name' ], 'force' => 1, 'flags' => 1, 'from' => 0, 'to' => 0 ]); ``` --- ๐Ÿ” GET vs POST ------------- [](#-get-vs-post) ``` // POST (default & recommended) Wialon::callPost('core/search_items', [...]); // GET (optional) Wialon::callGet('core/get_statistics', [...]); ``` --- ๐Ÿ” SSL & Certificate Handling (Killer Feature) ------------------------------------------------- [](#-ssl--certificate-handling-killer-feature) ### Automatic Fix [](#automatic-fix) ``` php artisan wialon:check --download # or php bin/console wialon:check --download ``` โœ” Downloads a valid Mozilla CA bundle โœ” Fixes cURL error 60 / 77 (Windows) โœ” Tests API connectivity Certificate location: ``` storage/certif/cacert.pem ``` --- ๐Ÿงช Error Handling ---------------- [](#-error-handling) ``` try { $data = Wialon::getUnits(); } catch (\RuntimeException $e) { // Handle HTTP or API errors } ``` --- โœ… Tests ------- [](#-tests) ``` vendor/bin/phpunit ``` --- ๐Ÿ“Œ Why This Package? ------------------- [](#-why-this-package) โœ” One SDK for **Laravel & Symfony**โœ” No SID headaches โœ” No SSL headaches โœ” Clean architecture โœ” Production-ready --- ๐Ÿ“œ License --------- [](#-license) MIT ### Health Score 19 โ€” LowBetter than 10% of packages Maintenance55 Moderate activity, may be stable Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity12 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/f3dddf9cef45710139b1ed66eb603104ce8634288b699bbe98e234129bc311b6?d=identicon)[Mecxer713](/maintainers/Mecxer713) --- Top Contributors [![Mecxer713](https://avatars.githubusercontent.com/u/28055700?v=4)](https://github.com/Mecxer713 "Mecxer713 (10 commits)") ### Embed Badge ![Health badge](/badges/mecxer713-wialon-package/health.svg) ``` [![Health](https://phpackages.com/badges/mecxer713-wialon-package/health.svg)](https://phpackages.com/packages/mecxer713-wialon-package) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api GitHub API v3 client 2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk PHP SDK for Facebook Business 90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 263103.1M454](/packages/google-gax) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)