PHPackages starinc/abigail - 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. [HTTP & Networking](/categories/http) 4. / 5. starinc/abigail ActiveLibrary[HTTP & Networking](/categories/http) starinc/abigail =============== Abigail is the fork from marcj/php-rest-service, which is a simple and fast PHP class for server side RESTful APIs. 1.0.2(4y ago)148[1 issues](https://github.com/star-inc/abigail/issues)MITPHPPHP >=7.4.0 Since Feb 22Pushed 2y agoCompare [ Source](https://github.com/star-inc/abigail)[ Packagist](https://packagist.org/packages/starinc/abigail)[ RSS](/packages/starinc-abigail/feed)WikiDiscussions main Synced today READMEChangelog (4)Dependencies (1)Versions (14)Used By (0) Abigail ======= [](#abigail) [![Integration](https://github.com/star-inc/Abigail/actions/workflows/integration.yml/badge.svg)](https://github.com/star-inc/Abigail/actions/workflows/integration.yml) Abigail is the fork from `marcj/php-rest-service`, which is a simple and fast PHP microservice framework for server side RESTful APIs. Features -------- [](#features) - Easy to use syntax - Regular Expression support - Error handling through PHP Exceptions - Parameter validation through PHP function signature - Can return a summary of all routes or one route through `OPTIONS` method based on PHPDoc (if `OPTIONS` is not overridden) - Support of `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD` and `OPTIONS` - Suppress the HTTP status code with ?\_suppress\_status\_code=1 (for clients that have troubles with that) - Supports ?\_method=`httpMethod` as addition to the actual HTTP method. - With auto-generation through PHP's `reflection` Installation ------------ [](#installation) - . - More information available under . Create a `composer.json`: ``` { "require": { "starinc/abigail": "*" } } ``` then run ``` $ wget https://getcomposer.org/composer.phar $ php composer.phar install ``` After the installation, you need to include the `vendor/autoload.php` to make the class in your script available. ``` include 'vendor/autoload.php'; ``` Requirements ------------ [](#requirements) - PHP 7.4 and above. - PHPUnit to execute the test suite. - Setup PATH\_INFO in mod\_rewrite (.htaccess) or other webserver configuration Example config -------------- [](#example-config) ### Apache webserver [](#apache-webserver) ``` #.htaccess RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteRule (.+) index.php/$1 [L,QSA] ``` ### Nginx webserver [](#nginx-webserver) ``` // edit virtualhost /etc/nginx/conf.d/name_virtualhost_file server { .. something params ... location / { include fastcgi_params; fastcgi_pass unix:/var/run/php-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root/index.php; } } // and add line to /etc/nginx/fastcgi_params fastcgi_param PATH_INFO $fastcgi_script_name; ``` Usage Demo ---------- [](#usage-demo) ### Way 1. The dirty & fast [](#way-1-the-dirty--fast) ``` use Abigail\Server; Server::create('/') ->addGetRoute('test', function(){ return 'Yay!'; }) ->addGetRoute('foo/(.*)', function($bar){ return $bar; }) ->addPostRoute('foo', function($field1, $field2) { // do stuff with $field1, $field2, etc. // or you can directly get them with $_POST['field1']. }) ->run(); ``` ### Way 2. Auto-Collection [](#way-2-auto-collection) `index.php`: ``` use Abigail\Server; Server::create('/admin', 'myRestApi\Admin') ->collectRoutes() ->run(); ``` `MyRestApi/Admin.php`: ``` namespace MyRestApi; class Admin { /** * Checks if a user is logged in. * * @return boolean */ public function getLoggedIn(){ return $this->getContainer('auth')->isLoggedIn(); } /** * @param string $username * @param string $password * @return boolean */ public function postLogin($username, $password){ return $this->getContainer('auth')->doLogin($username, $password); } /** * @param string $server * @url stats/([0-9]+) * @url stats * @return string */ public function getStats($server = '1'){ return $this->getServerStats($server); } } ``` Generates following entry points: ``` + GET /admin/logged-in + POST /admin/login?username=&password= + GET /admin/stats/([0-9]+) + GET /admin/stats ``` ### Way 3. Custom rules with controller [](#way-3-custom-rules-with-controller) `index.php`: ``` use Abigail\Server; Server::create('/admin', new MyRestApi\Admin) //base entry points `/admin` ->setDebugMode(true) //prints the debug trace, line number and file if an exception has been thrown. ->addGetRoute('login', 'doLogin') // => /admin/login ->addGetRoute('logout', 'doLogout') // => /admin/logout ->addGetRoute('page', 'getPages') ->addPutRoute('page', 'addPage') ->addGetRoute('page/([0-9]+)', 'getPage') ->addDeleteRoute('page/([0-9]+)', 'deletePage') ->addPostRoute('page/([0-9]+)', 'updatePage') ->addGetRoute('foo/bar/too', 'doFooBar') ->addSubController('tools', \RestApi\Tools) //adds a new sub entry point 'tools' => admin/tools ->addDeleteRoute('cache', 'clearCache') ->addGetRoute('rebuild-index', 'rebuildIndex') ->done() ->run(); ``` `MyRestApi/Admin.php`: ``` namespace MyRestApi; class Admin { public function login($username, $password){ if (!$this->validLogin($username, $password)) throw new InvalidLoginException('Login is invalid or no access.'); return $this->getToken(); } public function logout(){ if (!$this->hasSession()){ throw new NoCurrentSessionException('There is no current session.'); } return $this->killSession(); } public function getPage($id){ //... } } namespace RestAPI; class Tools { /** * Clears the cache of the app. * * @param boolean $withIndex If true, it clears the search index too. * @return boolean True if the cache has been cleared. */ public function clearCache($withIndex = false){ return true; } } ``` Responses --------- [](#responses) The response body is always an array (JSON per default) containing a status code and the actual data. If an exception has been thrown, it contains the status 500, the exception class name as error, and the message as message. Some examples: ``` + GET admin/login?username=foo&password=bar => { "status": "200", "data": true } + GET admin/login?username=foo&password=invalidPassword => { "status": "500", "error": "InvalidLoginException", "message": "Login is invalid or no access" } + GET admin/login => { "status: "400", "error": "MissingRequiredArgumentException", "message": "Argument 'username' is missing" } + GET admin/login?username=foo&password=invalidPassword With active debugMode we'll get: => { "status": "500", "error": "InvalidLoginException", "message": "Login is invalid or no access", "line": 10, "file": "libs/RestAPI/Admin.class.php", "trace": } + GET admin/tools/cache => { "status": 200, "data": true } ``` License ------- [](#license) Licensed under the MIT License. See the LICENSE file for more details. Take a look into the code, to get more information about the possibilities. It's well documented. ### Health Score 26 — LowBetter than 43% of packages Maintenance0 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community14 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 68.6% 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 ~288 days Recently: every ~721 days Total 12 Last Release 1652d ago Major Versions 0.2.0 → 1.0.02021-10-24 PHP version history (2 changes)0.1.0PHP >=5.3.0 0.2.0PHP >=7.4.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/38f897ba562b60e18b423ee34e1363319f7d5c06a33fcb54a59dd37d32599768?d=identicon)[supersonictw](/maintainers/supersonictw) --- Top Contributors [![supersonictw](https://avatars.githubusercontent.com/u/13705584?v=4)](https://github.com/supersonictw "supersonictw (35 commits)")[![marcj](https://avatars.githubusercontent.com/u/450980?v=4)](https://github.com/marcj "marcj (4 commits)")[![ntvsx193](https://avatars.githubusercontent.com/u/2971095?v=4)](https://github.com/ntvsx193 "ntvsx193 (3 commits)")[![urkle](https://avatars.githubusercontent.com/u/101123?v=4)](https://github.com/urkle "urkle (2 commits)")[![freinn](https://avatars.githubusercontent.com/u/2404609?v=4)](https://github.com/freinn "freinn (2 commits)")[![mamartel](https://avatars.githubusercontent.com/u/1738891?v=4)](https://github.com/mamartel "mamartel (1 commits)")[![olect](https://avatars.githubusercontent.com/u/1047183?v=4)](https://github.com/olect "olect (1 commits)")[![superdave2u](https://avatars.githubusercontent.com/u/3734136?v=4)](https://github.com/superdave2u "superdave2u (1 commits)")[![DeyV](https://avatars.githubusercontent.com/u/311626?v=4)](https://github.com/DeyV "DeyV (1 commits)")[![bitdeli-chef](https://avatars.githubusercontent.com/u/3092978?v=4)](https://github.com/bitdeli-chef "bitdeli-chef (1 commits)") --- Tags apiphpphp7php8restrestfulrestful-apiphpapirestrestful ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/starinc-abigail/health.svg) ``` [![Health](https://phpackages.com/badges/starinc-abigail/health.svg)](https://phpackages.com/packages/starinc-abigail) ``` ### Alternatives [ismaeltoe/osms PHP library wrapper of the Orange SMS API. 4540.0k](/packages/ismaeltoe-osms) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)