PHPackages psfs/core - 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. psfs/core ActiveLibrary[Framework](/categories/framework) psfs/core ========= Php Simple Fast & Secure 2.2.5(1mo ago)61.0k↓26.7%52MITPHPPHP >=8CI passing Since Oct 10Pushed 1mo ago3 watchersCompare [ Source](https://github.com/psfs/core)[ Packagist](https://packagist.org/packages/psfs/core)[ Docs](https://github.com/psfs/core)[ RSS](/packages/psfs-core/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (23)Versions (35)Used By (2) PSFS ==== [](#psfs) [![Build Status](https://camo.githubusercontent.com/f13e8a04091fcff288ded07d0061424f7ee5c79123bf2d216dbf219ccedf50f6/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f707366732f636f72652f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/psfs/core/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/ce22a5dcf73d21b92b6d16f261ee7cb45846bc8f4596306b47a44f66a2fbff60/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f707366732f636f72652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/psfs/core/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/6937bc571e5e1c0236eed8abb97a7d00b6fd3d6c462920b4eee51a6bb44c4ba0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f707366732f636f72652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/psfs/core/?branch=master)[![Packagist Stable Version](https://camo.githubusercontent.com/3f7c8473782333267d74f30b3a4a2c2cf311c673c0e9ac4faa9c45837a6306ef/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f707366732f636f7265)](https://packagist.org/packages/psfs/core)[![Development Line](https://camo.githubusercontent.com/8b7f11f370d32c33ef0726a8631496f04de8ef66a55f28b5faceb44e9192b617/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6465762d2d6d61737465722d322e322e782d2d6465762d304137424242)](https://github.com/psfs/core/tree/master)[![PHP 8.3](https://camo.githubusercontent.com/6fb4fa43a4fd01011e071367ba9219a31399b8615ba0c56bba733799ce5a0845/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e332d3737374242342e7376673f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/releases/8.3/en.php) PHP Simple Fast & Secure Framework -------------------------------------- [](#php-simple-fast--secure-framework) PSFS is a lightweight PHP framework focused on MVC/API applications with Twig, Propel, and Symfony components. Runtime baseline ---------------- [](#runtime-baseline) - Project execution and validation run with Docker Compose. - Runtime PHP version is **8.3**. - Default host port is defined in the root `.env` via `HOST_PORT=8008`. - Main local services in `docker-compose.yml` are `php`, `redis`, and `db`. Direct PHP requirements declared in `composer.json`: - `php >=8` - `ext-json` - `ext-curl` - `ext-gmp` Core package constraints currently used by the framework: ``` psfs/propel: dev-master symfony/console: ^7.4 symfony/finder: ^7.4 symfony/translation: ^7.4 twig/twig: ^3.24 monolog/monolog: ^3.10 matthiasmullie/minify: ^1.3 firebase/php-jwt: ^7.0 ``` Local development ----------------- [](#local-development) Start the stack: ``` docker compose up -d docker compose ps ``` The PHP container is usually named `core-php-1`. If needed, discover it with: ``` docker compose ps docker ps --format '{{.Names}}' ``` Run project commands from the PHP container: ``` docker exec php -v docker exec composer install docker exec php vendor/bin/phpunit ``` The application server exposed by Docker runs: ``` php -S 0.0.0.0:8080 -t ./html ``` and is published on the host as `${HOST_PORT}:8080`. Consumer install ---------------- [](#consumer-install) If you want to use PSFS as a Composer dependency in another project: ``` composer init composer require psfs/core ./vendor/bin/psfs psfs:create:root ``` The `psfs:create:root` command generates the document root structure. Published package note: - Packagist stable release is currently `2.0.1`. - Repository head is on the `2.2.x-dev` development line. Validation ---------- [](#validation) Mandatory baseline before review: ``` docker compose up -d docker compose ps docker exec php -v docker exec php vendor/bin/phpunit ``` Optional coverage when Xdebug is available: ``` docker exec -e XDEBUG_MODE=coverage php vendor/bin/phpunit --coverage-text ``` Do not run `php`, `composer`, or `phpunit` directly on the host for project validation. Security/Auth contract (v2) --------------------------- [](#securityauth-contract-v2) - Auth/cookies are versioned as **v2** with **legacy fallback in read-only mode**. - Expected result for invalid auth is `null/null` and the request flow must be stopped. - Compatibility policy: active fallbacks are temporary and can be removed only with explicit user approval. - Target cookie policy: - `HttpOnly=true` - `Secure=true` when running on HTTPS - `SameSite=Lax` or `SameSite=Strict` - `Path=/` - coherent `Domain` - TTL aligned with auth/session policy Review and commit policy ------------------------ [](#review-and-commit-policy) - Changes must be reviewed by a human before commit. - Do not auto-commit after automated changes or agent execution. Environment variables --------------------- [](#environment-variables) Relevant Docker/runtime variables: ``` APP_ENVIRONMENT=(local|dev|...|prod) HOST_PORT=8008 DEBUG=-xdebug PHP_TIMEZONE=Europe/Madrid PHP_OPCACHE=0 MYSQL_USER=psfs MYSQL_PASSWORD=psfs MYSQL_ROOT_PASSWORD=psfs MYSQL_DATABASE=psfs ``` `DEBUG=-xdebug` loads the Xdebug image variant. An empty value uses the default PHP image. Versioning ---------- [](#versioning) - Packagist stable release: `2.0.1` - Active development line: `dev-master -> 2.2.x-dev` - Release/tag policy is documented in `doc/VERSIONING.md` Documentation ------------- [](#documentation) - [General information and contracts](./doc/CONTRACTS.md) - [Versioning policy](./doc/VERSIONING.md) - [Async queue and connector contracts](./doc/contracts/async-jobs-connectors-contracts.md) - [Security policy](./SECURITY.md) Roadmap ------- [](#roadmap) - Framework documentation - PhpDoc for all files - Testing - 100% tests coverage ### Health Score 56 — FairBetter than 98% of packages Maintenance89 Actively maintained with recent releases Popularity26 Limited adoption so far Community21 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor1 Top contributor holds 92.9% 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 ~126 days Recently: every ~2 days Total 34 Last Release 54d ago Major Versions v0.9.3 → v1.0.02017-08-28 v1.3.0 → v2.0.0.x-dev2023-06-03 2.1.6 → 3.1.62026-01-08 PHP version history (7 changes)v0.9.2PHP ^5.5 || ^7.0 v0.9.3PHP ^5.6 || ^7.0 v1.1.0PHP ^7.0 v1.3.0PHP ^7.1 v2.0.0.x-devPHP ^8.2 2.1.0.x-devPHP >=8.2 2.1.3PHP >=8 ### Community Maintainers ![](https://www.gravatar.com/avatar/3b003d22a9e86075d99de95d22b758300f600cd3c3c8eabc11cea31fe53ea81e?d=identicon)[c15k0](/maintainers/c15k0) --- Top Contributors [![c15k0](https://avatars.githubusercontent.com/u/2992619?v=4)](https://github.com/c15k0 "c15k0 (527 commits)")[![fl-bloombees](https://avatars.githubusercontent.com/u/14823253?v=4)](https://github.com/fl-bloombees "fl-bloombees (29 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (8 commits)")[![dmoyadev](https://avatars.githubusercontent.com/u/9676003?v=4)](https://github.com/dmoyadev "dmoyadev (2 commits)")[![gabmarfer](https://avatars.githubusercontent.com/u/2932209?v=4)](https://github.com/gabmarfer "gabmarfer (1 commits)") --- Tags apicomposerdockerdocker-composephppropelrestfulphpapiframeworktwigmvcrestful ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/psfs-core/health.svg) ``` [![Health](https://phpackages.com/badges/psfs-core/health.svg)](https://phpackages.com/packages/psfs-core) ``` ### Alternatives [shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop)[silverstripe/framework The SilverStripe framework 7213.5M2.5k](/packages/silverstripe-framework)[contao/core-bundle Contao Open Source CMS 1231.6M2.4k](/packages/contao-core-bundle)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)