PHPackages swiftphp.ma/installer - 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. swiftphp.ma/installer ActiveLibrary[Framework](/categories/framework) swiftphp.ma/installer ===================== Modern PHP framework with AI-powered CLI, built-in auth, multi-tenant support, and 70% less code v1.0.0(5mo ago)07MITPHPPHP >=8.1CI failing Since Dec 2Pushed 5mo agoCompare [ Source](https://github.com/moaminemahnoudi/swiftphp)[ Packagist](https://packagist.org/packages/swiftphp.ma/installer)[ RSS](/packages/swiftphpma-installer/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) SwiftPHP Framework ================== [](#swiftphp-framework) Modern PHP framework with an expressive router, a simple ORM, built-in authentication, multi-tenant support, middleware, validation, and a lightweight view system. Ships with an AI-friendly CLI to generate controllers, models, and migrations fast — aiming for 70% less boilerplate. > SwiftPHP targets PHP 8+ and PSR-12 coding style. It’s ideal for small to medium apps, dashboards, APIs, and admin tools. Repository: --- Features -------- [](#features) - Routing: Simple, declarative routes with controller binding - Controllers: Base controller with dependency injection via attributes - ORM & Query Builder: Lightweight `Model` + `ModelQuery` with `Database` and `QueryBuilder` - Migrations: Built-in migrator and generator via CLI - Authentication: Session-based auth helpers and middleware - Multi-Tenant: Tenant resolution + role-based access via traits - Middleware: Auth, CORS, Rate Limiting, Roles, Tenant - Validation: Declarative validation with `Validator` and exceptions - Views: PHP templates (`.swift.php`) with layout and components - CLI: `swiftphp` to generate, migrate, serve, and scaffold resources - Error Handling: Friendly error template and handler - Security: Helpers to harden common web risks --- Requirements ------------ [](#requirements) - PHP 8.1+ - Composer - PDO extension for your database (e.g., MySQL, SQLite) --- Installation ------------ [](#installation) You can install globally (installer) or scaffold directly from source. ### Packagist (recommended) [](#packagist-recommended) Once published: ``` composer global require swiftphp.ma/installer composer create-project swiftphp.ma/installer my-app ``` ### From Source (this repository) [](#from-source-this-repository) ``` # Install dependencies composer install # Ensure storage directories exist mkdir storage\views # Start PHP built-in server php -S localhost:8000 -t public ``` Open `http://localhost:8000` in your browser. --- Quick Start ----------- [](#quick-start) 1. Configure app and database: - `config/app.php` - `config/database.php` 2. Run migrations: ``` # Windows PowerShell php bin\swiftphp migrate ``` 3. Start the server: ``` php -S localhost:8000 -t public ``` 4. Visit `http://localhost:8000` — default `home.swift.php` view renders. --- Documentation ------------- [](#documentation) - [Getting Started](docs/getting-started.md) - [Architecture Overview](docs/architecture.md) - [Best Practices](docs/best-practices.md) - [Code Quality Standards](docs/code-quality.md) - [FAQ](docs/faq.md) --- Project Structure ----------------- [](#project-structure) ``` app/ Controllers/ # Application controllers Models/ # Domain models (extends src/Core/Model) config/ # App + DB config database/migrations/ # Migration files public/ # Front controller (index.php) resources/views/ # Views (layouts, components, pages) src/ # Framework source (core, router, db, console, etc.) storage/views/ # Compiled/cached views ``` Key framework modules: - `src/Core`: Application, Container, Controller, Model, Router - `src/Http`: Request, Response - `src/Database`: Database, QueryBuilder - `src/Auth`: Auth helpers, Tenant - `src/Middleware`: Middleware base and built-ins - `src/Validation`: Validator, ValidationException - `src/View`: View engine - `src/Console`: CLI application + commands --- Routing ------- [](#routing) Define routes in `public/index.php` using the Router. Example: ``` use Src\Core\Application; use Src\Core\Router; use App\Controllers\UserController; $app = new Application(); $router = new Router($app); $router->get('/', [UserController::class, 'home']); $router->get('/users', [UserController::class, 'index']); $router->get('/users/{id}', [UserController::class, 'show']); $router->post('/users', [UserController::class, 'store']); $router->dispatch(); ``` Route parameters like `{id}` are available via `Request`. --- Controllers ----------- [](#controllers) Controllers live in `app/Controllers` and extend `Src\Core\Controller`. ``` namespace App\Controllers; use Src\Core\Controller; use Src\Http\Request; use App\Models\User; class UserController extends Controller { public function index(Request $request) { $users = User::query()->get(); return $this->view('users/index', compact('users')); } } ``` Dependency injection is supported via the container and `Attributes\Inject`. --- Models & Querying --------------------- [](#models--querying) Models extend `Src\Core\Model`. A simple `User` model: ``` namespace App\Models; use Src\Core\Model; class User extends Model { protected string $table = 'users'; protected array $fillable = ['name', 'email']; } ``` Query examples: ``` $all = User::query()->get(); $one = User::query()->where('id', 1)->first(); User::query()->insert(['name' => 'Ada', 'email' => 'ada@example.com']); User::query()->update(1, ['name' => 'Ada Lovelace']); User::query()->delete(1); ``` --- Migrations ---------- [](#migrations) Migration files live in `database/migrations`. Use the CLI to create and run them. ``` # Generate migration php bin\swiftphp make:migration create_posts_table # Run migrations php bin\swiftphp migrate ``` Example migration file name: `2024_01_01_000000_create_users_table.php`. --- Views ----- [](#views) SwiftPHP uses plain PHP templates with a `.swift.php` suffix. - Layouts: `resources/views/layouts/app.swift.php` - Components: `resources/views/components/*.swift.php` - Pages: `resources/views/*.swift.php` Render from a controller: ``` return $this->view('users/index', ['users' => $users]); ``` The engine compiles views to `storage/views` for performance. --- Authentication & Authorization ---------------------------------- [](#authentication--authorization) - `src/Auth/Auth.php`: login, logout, current user helpers - `src/Middleware/AuthMiddleware.php`: gate routes to authenticated users - `src/Traits/HasRoles.php`: role management on models - `src/Auth/Tenant.php` + `src/Traits/HasTenant.php`: multi-tenant helpers Apply middleware on routes or in controller dispatch. --- Middleware ---------- [](#middleware) Built-ins: - `AuthMiddleware` - `CorsMiddleware` - `RateLimitMiddleware` - `RoleMiddleware` - `TenantMiddleware` Register and apply to routes via the router or a pipeline. --- Validation ---------- [](#validation) Use `Src\Validation\Validator` to validate request data. ``` use Src\Validation\Validator; Validator::make($request->all(), [ 'email' => ['required', 'email'], 'name' => ['required', 'min:2'] ])->validate(); ``` On failure, throws `ValidationException` which the error handler renders. --- CLI Commands ------------ [](#cli-commands) Run via `php bin\\swiftphp` (or `bin\\swiftphp.bat` on Windows): - `new`: Scaffold a new project - `serve`: Start a dev server - `make:controller`: Generate a controller - `make:model`: Generate a model - `make:migration`: Generate a migration - `migrate`: Run migrations - `help`: Show available commands Examples: ``` php bin\swiftphp serve php bin\swiftphp make:controller UserController php bin\swiftphp make:model User php bin\swiftphp make:migration add_auth_fields_to_users_table php bin\swiftphp migrate ``` --- Configuration ------------- [](#configuration) - `config/app.php`: app name, env, debug, timezone, etc. - `config/database.php`: driver, host, database, user, password Use environment variables via `src/Support/Env.php`. --- Error Handling & Security ----------------------------- [](#error-handling--security) - Error pages via `src/Error/error_template.php` - Central `ErrorHandler` to catch and render - `src/Security/Security.php` provides helpers for sanitization and headers --- Publishing ---------- [](#publishing) See `PUBLISHING.md` for full Packagist steps: - Tag releases (e.g., `v1.0.0`) - Submit GitHub repo to Packagist - Optionally configure auto-update hooks --- Contributing ------------ [](#contributing) Contributions are welcome! Please read `CONTRIBUTING.md` for guidelines. - Follow PSR-12 - Add tests when possible - Update `CHANGELOG.md` for user-facing changes Security issues? See `SECURITY.md` for our policy. --- License ------- [](#license) MIT. See `LICENSE`. --- FAQ --- [](#faq) - Where do I define routes? - In `public/index.php` using `Router`. - How do I enable auth-protected pages? - Register `AuthMiddleware` on routes or controllers. - Does it support JSON APIs? - Yes. Use `Response` to return JSON and skip views. - Can I use SQLite? - Yes. Configure `config/database.php` for SQLite with PDO. --- Credits ------- [](#credits) Built with care by the SwiftPHP community. ### Health Score 32 — LowBetter than 72% of packages Maintenance70 Regular maintenance activity Popularity4 Limited adoption so far Community2 Small or concentrated contributor base Maturity43 Maturing project, gaining track record 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 Unknown Total 1 Last Release 167d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/9d7ff8ba35f2dcdfc1dd238f09f9a113959e139351706f79d64747a5f3ebfae3?d=identicon)[moaminemahnoudi](/maintainers/moaminemahnoudi) --- Tags phpmiddlewareframeworkvalidationrouteraiexportAuthenticationormcollectionsmvcmulti-tenantgenai ### Embed Badge ![Health badge](/badges/swiftphpma-installer/health.svg) ``` [![Health](https://phpackages.com/badges/swiftphpma-installer/health.svg)](https://phpackages.com/packages/swiftphpma-installer) ``` ### Alternatives [phpmv/ubiquity Ubiquity-framework 70038.8k6](/packages/phpmv-ubiquity)[letsdrink/ouzo Ouzo PHP MVC framework 7210.5k1](/packages/letsdrink-ouzo)[mirekmarek/php-jet PHP Jet is modern, powerful, real-life proven, really fast and secure, small and light-weight framework for PHP8 with great clean and flexible modular architecture containing awesome developing tools. No magic, just clean software engineering. 241.3k](/packages/mirekmarek-php-jet) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)