PHPackages jitsu/jitsu - 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. jitsu/jitsu ActiveLibrary[Framework](/categories/framework) jitsu/jitsu =========== PHP web framework and project generator 0.1.1(9y ago)022MITPHPPHP >=5.4.0 Since May 7Pushed 9y ago1 watchersCompare [ Source](https://github.com/bdusell/jitsu)[ Packagist](https://packagist.org/packages/jitsu/jitsu)[ RSS](/packages/jitsu-jitsu/feed)WikiDiscussions master Synced 4w ago READMEChangelogDependencies (6)Versions (3)Used By (0) Jitsu: PHP on easy mode ----------------------- [](#jitsu-php-on-easy-mode) **jitsu 実（じつ）** n. truth, reality; fidelity Jitsu is a suite of PHP libraries for building modern web applications and REST APIs. Its purpose is to help you cut straight to the task at hand instead of struggling with the many shortcomings and idiosyncracies of the PHP language and its standard library. Projects based on Jitsu are designed to be trivial to install and configure on any system which has Apache set up to process `.php` and `.htaccess` files – a ubiquitous setup, especially in shared hosting environments. This repository comes with a project generator which can be used to set up new Jitsu projects quickly and easily. Motivation ---------- [](#motivation) PHP is a nice tool for novice web developers. For starters, most web servers come pre-configured to run PHP without any additional effort. You can write "hello world" to a file named `index.php` and *boom*, you have a web page. Put some more code in some more files, and you can make a whole website. For the casual user, PHP looks and feels like magic HTML. Because PHP is a templating language, all of the languages essential for web development can coexist in the same source file. To take a common example, this reduces the complexity of HTML form submission to writing the appropriate HTML markup, and retrieving the submitted values through `$_REQUEST`, all in the same script. Play it right, and you can always have all of your HTML, CSS, JavaScript, backend logic, SQL queries, etc. in one big ball-o'-code. Obviously, this language-fiesta approach is not suitable for larger projects. As soon as your aspirations evolve from "how do I make a web page which asks for the user's name?" to "how do I make a REST API service for my web app?" the built-in APIs tend to hinder more than help. What might be their worst aspect is that many of these built-in features have unusual interfaces or use names which are just plain difficult to remember. Some features, like setting cookies, are function calls. Others things, like reading cookies, are done through superglobal array variables. Still other things come in the form of special file stream names like `php://input`. *Ad nauseam.* It doesn't help that many of the built-in string and array functions behave poorly on edge cases. A lot of functions give you the error "empty needle" if you, say, try to test whether a string contains the empty string. String and array slicing gets really messy whenever you can't ensure that all the indices end up within the boundaries. And let's *not even get started* on error handling in PHP. Jitsu offers a saner PHP development experience, providing memorable function names, well-behaved string and array functions, disciplined error handling, object-oriented HTTP requests and responses, request routing, and more. A few highlights include: - Auto-loading for all classes under the `Jitsu` namespace. Jitsu is composed of a number of [Composer](https://getcomposer.org/) packages, all of which support [PSR-4](http://www.php-fig.org/psr/psr-4/)-compliant auto-loading. - An `Application` class which serves as an extensible HTTP request router. - Request and response interfaces which decouple clients from superglobals like `$_GET`, `$_SERVER`, etc. - A much more succinct API for SQL databases built upon PHP's PDO library. - Many, many static utility functions for string and array manipulation, regular expression matching, introspection, functional programming, etc. - Wrapper classes `XArray`, `XString`, and `XRegex` which offer a rich, object-oriented interface to native PHP data types and support method chaining. - Other features are in the works, like a SQL syntax abstraction layer and an ORM. Component Libraries ------------------- [](#component-libraries) - [jitsu/app](https://github.com/bdusell/jitsu-app): Routing and configuration for web apps - [jitsu/http](https://github.com/bdusell/jitsu-http): HTTP request and response interfaces - [jitsu/sqldb](https://github.com/bdusell/jitsu-sqldb): Awesome OOP interface to SQL databases - [jitsu/error](https://github.com/bdusell/jitsu-error): Error handling done right - [jitsu/wrap](https://github.com/bdusell/jitsu-wrap): OOP wrappers for native data types with chainable methods - [jitsu/util](https://github.com/bdusell/jitsu-util): Indispensable helper functions - [jitsu/array](https://github.com/bdusell/jitsu-array): Re-designed array library - [jitsu/string](https://github.com/bdusell/jitsu-string): Re-designed string library - [jitsu/regex](https://github.com/bdusell/jitsu-regex): Re-designed regular expression library Project Generator ----------------- [](#project-generator) This package contains a project generator which can be used to set up the skeleton for a fully-functional Jitsu-based web app in seconds. Note that you will need to have Composer, NPM, and Gulp pre-installed. This script works much like the Ruby on Rails generator – simply create a new project in a directory of your choosing, then check the generated files into version control and get to work! The generator comes in the form of an executable PHP script named `jitsu` and can be obtained either by cloning the repository – ``` git clone https://github.com/bdusell/jitsu.git ``` – in which case it can be found under the `bin/` directory, or by installing the `jitsu/jitsu` Composer package – ``` composer require jitsu/jitsu ``` – in which case the script will be made available in the `vendor/bin/`directory of your project managed by Composer. Either way, you may want to add the directory containing the script to your `PATH`. The syntax of the `jitsu` command is: ``` jitsu create ``` Quickstart ---------- [](#quickstart) If you haven't done so already, install [Composer](https://getcomposer.org/), [NPM](https://www.npmjs.com/), and [Gulp](http://gulpjs.com/). To clone this repo and create a new empty project: ``` git clone https://github.com/bdusell/jitsu.git cd jitsu composer update cd .. ./jitsu/bin/jitsu create MyBlog cd MyBlog ``` Alternatively, to download the generator as a Composer package: ``` composer require jitsu/jitsu ./vendor/bin/jitsu create MyBlog cd MyBlog ``` At this point you will probably want to serve the app through Apache for local testing. On Ubuntu Linux, for example, you can do this by creating a symlink to the `build/dev` directory under `/var/www/` (this assumes you already have Apache and its PHP module installed): ``` sudo ln -s "$PWD/build/dev" /var/www/my-blog-dev ``` The web page can now be accessed at , but it displays "Forbidden" because the build directory has not been created yet, and because you haven't told Jitsu how to tell Apache where to find it. By design, you need to configure the document root for the app explicitly: ``` sed -i 's|YOUR_DOCUMENT_ROOT|/var/www/my-blog-dev|' src/etc/config.dev.php ``` Even if you create the build directory at this point, it will display an error message saying something like "misconfigured base path." This is because you also need to set the path where the app will be "mounted" publicly on the server. Since we named the symlink `my-blog-dev` in this example, we should change it to `/my-blog-dev/`: ``` sed -i 's|YOUR_BASE_PATH|/my-blog-dev/|' src/etc/config.dev.php ``` Afterwards, to pre-compile the static CSS and JavaScript assets in debug mode and create the build directory: ``` gulp build:dev ``` You should now be able to view the working web page at , which says "Hello, world!" 実 ### Health Score 23 — LowBetter than 26% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity49 Maturing project, gaining track record 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 ~154 days Total 2 Last Release 3552d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/cca83b66140c874bd446e8cfb132f5c1d4e4747a2a58f465b47d2b618e27ff1c?d=identicon)[bdusell](/maintainers/bdusell) --- Top Contributors [![bdusell](https://avatars.githubusercontent.com/u/5336190?v=4)](https://github.com/bdusell "bdusell (245 commits)") --- Tags phpphp-frameworkrestweb-appweb-developmentweb-frameworkframeworkgeneratorproject ### Embed Badge ![Health badge](/badges/jitsu-jitsu/health.svg) ``` [![Health](https://phpackages.com/badges/jitsu-jitsu/health.svg)](https://phpackages.com/packages/jitsu-jitsu) ``` ### Alternatives [tecnocen/yii2-formgenerator Yii 2 Library to configure form generator 135.7k](/packages/tecnocen-yii2-formgenerator) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)