# Slim 中文文檔
> 來源:[Slim 中文文檔](http://www.slimphp.net/docs/)
此處的文檔針對 **Slim 3** 。要查閱 Slim 2 的文檔請訪問 [docs.slimframework.com](http://docs.slimframework.com/) 。
## 歡迎使用
Slim是一款 PHP 微框架,可以幫助你快速編寫簡單但功能強大的 web 應用和 API 。在它的核心,Slim 是一個調度程序,它接收一個 HTTP 請求,調用一個適當的回調例程,然后返回一個 HTTP 響應。就這樣簡單。
## 重點是什么?
Slim 是一個理想的工具,用來創建銷毀、重用或發布數據。Slim 也是一個用來快速構建原型的好工具。呃,那啥,你甚至可以用 Slim 來創建帶有用戶界面的功能完整的 web 應用程序。更重要的是,Slim 速度超快,代碼很簡單。實際上,一個下午你就能讀完并理解它的源代碼!
> 在它的核心,Slim 是一個調度程序,它接收一個 HTTP 請求,調用一個適當的回調例程,然后返回一個 HTTP 響應。就這樣簡單。
你并不總是需要一套全方位的解決方案,比如 [Symfony](http://symfony.com/) 或者 [Laravel](http://laravel.com/) 。當然,它們都是了不起的工具。但它們往往矯枉過正。相反,Slim 只最小限度地提供你所需要用的工具,沒有其他多余的東西。
## 它如何工作?
首先,你需要一個 web 服務器,比如 Nginx 或 Apache 。你需要[配置你的 web 服務器](/docs/start/web-servers.html)讓它發送所有適當的請求到一個“前端控制器” PHP 文件。你就在這個 PHP 文件里實例化并運行你的 Slim 應用。
一個 Slim 應用包含多個響應特定 HTTP 請求的路由。每個路由調用一個回調并返回一個 HTTP 響應。在剛開始的時候,你首先實例化并配置 Slim 應用。下一步,定義你的應用程序的路由。最后,運行你的 Slim 應用程序。這很簡單吧?這里有一個實例應用程序:
```
<?php
// 創建并配置 Slim app $app = new \Slim\App;
// 定義 app 路由 $app->get('/hello/{name}', function ($request, $response, $args) {
return $response->write("Hello " . $args['name']);
});
// 運行 app $app->run();
```
Figure 1: Slim 示例應用
## 請求和響應
當你構建一個 Slim 應用時,你會經常直接與請求對象和響應對象打交道。這些對象表示由 web 服務器實際接收到的 HTTP 請求,以及最終返回給客戶端的 HTTP 響應。
Slim 應用程序的每個路由都將前的請求對象和響應對象作為它的回調例程的參數。這些對象實現了流行的 [PSR 7](/docs/concepts/value-objects.html) 接口。Slim 應用的路由可以必要地檢查或操作這些對象。最終,每個 Slim應用路由**必然**返回一個 PSR 7 響應對象。
## 加入你自己的組件
Slim 可以良好地兼容其他 PHP 組件。你可以注冊第三方組件,比如 [Slim-Csrf](https://github.com/slimphp/Slim-Csrf/), [Slim-HttpCache](https://github.com/slimphp/Slim-HttpCache), 或 [Slim-Flash](https://github.com/slimphp/Slim-Flash) 這種基于 Slim 默認功能上的組件。Slim 還可以很容易地集成那些從[Packagist](https://packagist.org/)上找到的第三方組件。
## 如何閱讀這份文檔
如果你是第一次接觸 Slim,我建議你從頭到尾先閱讀一遍。如果你已經和 Slim 混得比較熟了,你可以直接去閱讀你想看的部分。
本文檔從解釋 Slim 的概念和架構開始,而不是貿然開始講述請求和響應處理、路由、錯誤處理這些特定的話題。特定的話題。(中文文檔若有錯誤或不準確,請務必反饋一下哦)