Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A PHP micro framework inspired by Sinatra
Pull request Compare This branch is 2 commits ahead, 360 commits behind slimphp:2.x.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Slim Framework

Build Status

Slim is a PHP micro framework that helps you quickly write simple yet powerful web applications and APIs. Slim is easy to use for both beginners and professionals. Slim favors cleanliness over terseness and common cases over edge cases. Its interface is simple, intuitive, and extensively documented — both online and in the code itself. Thank you for choosing the Slim Framework for your next project. I think you're going to love it.


  • Powerful router
    • Standard and custom HTTP methods
    • Route parameters with wildcards and conditions
    • Route redirect, halt, and pass
    • Route middleware
  • Template rendering with custom views
  • Flash messages
  • Secure cookies with AES-256 encryption
  • HTTP caching
  • Logging with custom log writers
  • Error handling and debugging
  • Middleware and hook architecture
  • Simple configuration

Getting Started


You may install the Slim Framework with Composer (recommended) or manually.

Read how to install Slim

System Requirements

You need PHP >= 5.3.0. If you use encrypted cookies, you'll also need the mcrypt extension.

Hello World Tutorial

Instantiate a Slim application:

$app = new \Slim\Slim();

Define a HTTP GET route:

$app->get('/hello/:name', function ($name) {
    echo "Hello, $name";

Run the Slim application:


Setup your web server


Ensure the .htaccess and index.php files are in the same public-accessible directory. The .htaccess file should contain this code:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [QSA,L]


Your nginx configuration file should contain this code (along with other settings you may need) in your location block:

try_files $uri $uri/ /index.php;

This assumes that Slim's index.php is in the root folder of your project (www root).


Your lighttpd configuration file should contain this code (along with other settings you may need). This code requires lighttpd >= 1.4.24.

url.rewrite-if-not-file = ("^" => "/index.php")

This assumes that Slim's index.php is in the root folder of your project (www root).


How to Contribute

Pull Requests

  1. Fork the Slim Framework repository
  2. Create a new branch for each feature or improvement
  3. Send a pull request from each feature branch to the develop branch

It is very important to separate new features or improvements into separate feature branches, and to send a pull request for each branch. This allows me to review and pull in new features or improvements individually.

Style Guide

All pull requests must adhere to the PSR-2 standard.

Unit Testing

All pull requests must be accompanied by passing unit tests and complete code coverage. The Slim Framework uses phpunit for testing.

Learn about PHPUnit


Forum and Knowledgebase

Visit Slim's official forum and knowledge base at where you can find announcements, chat with fellow Slim users, ask questions, help others, or show off your cool Slim Framework apps.


Follow @slimphp on Twitter to receive news and updates about the framework.


The Slim Framework is created and maintained by Josh Lockhart. Josh is a senior web developer at New Media Campaigns. Josh also created and maintains PHP: The Right Way, a popular movement in the PHP community to introduce new PHP programmers to best practices and good information.


The Slim Framework is released under the MIT public license.

Something went wrong with that request. Please try again.