Slim 框架,一个 PHP 微型框架

2.1.0 2012-09-12 16:07 UTC

README

Build Status

Slim 是一个 PHP 微型框架,可以帮助您快速编写简单而强大的 Web 应用程序和 API。Slim 适用于初学者和专业人员。Slim 倾向于简洁而非冗长,以及常见情况而非边缘情况。其界面简单、直观,并且有详尽的在线和代码本身文档。感谢您选择 Slim 框架作为您的下一个项目。我相信您会喜欢它的。

特性

  • 强大的路由器
    • 标准自定义 HTTP 方法
    • 带有通配符和条件的路由参数
    • 路由重定向、停止和传递
    • 路由中间件
  • 使用自定义视图的模板渲染
  • 闪存消息
  • 使用 AES-256 加密的加密 cookie
  • HTTP 缓存
  • 使用自定义日志记录器的日志记录
  • 错误处理和调试
  • 中间件和钩子架构
  • 简单配置

入门

安装

您可以使用 Composer(推荐)或手动安装 Slim 框架。

阅读如何安装 Slim

系统要求

您需要 PHP >= 5.3.0。如果您使用加密 cookie,您还需要 mcrypt 扩展。

Hello World 教程

实例化 Slim 应用程序

$app = new \Slim\Slim();

定义 HTTP GET 路由

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

运行 Slim 应用程序

$app->run();

设置您的 Web 服务器

Apache

请确保 .htaccessindex.php 文件位于同一公开可访问的目录中。 .htaccess 文件应包含以下代码

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

Nginx

您的 nginx 配置文件应在 location 块中包含以下代码(以及其他可能需要的设置)

try_files $uri $uri/ /index.php;

这假设 Slim 的 index.php 在您项目的根目录中(www 根)。

lighttpd

您的 lighttpd 配置文件应包含以下代码(以及其他可能需要的设置)。此代码需要 lighttpd >= 1.4.24。

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

这假设 Slim 的 index.php 在您项目的根目录中(www 根)。

文档

http://docs.slimframework.com/

如何贡献

拉取请求

  1. 分叉 Slim 框架存储库
  2. 为每个功能或改进创建一个新的分支
  3. 从每个功能分支发送拉取请求到 develop 分支

将新功能或改进分开到单独的功能分支,并为每个分支发送拉取请求非常重要。这样可以让我单独审查和合并新功能或改进。

风格指南

所有拉取请求都必须遵循PSR-2 标准。

单元测试

所有拉取请求都必须附带通过单元测试和完整的代码覆盖率。Slim 框架使用 phpunit 进行测试。

了解 PHPUnit

社区

论坛和知识库

访问 Slim 的官方论坛和知识库 http://help.slimframework.com,在那里您可以找到公告、与 fellow Slim 用户聊天、提问、帮助他人或展示您酷炫的 Slim 框架应用程序。

Twitter

关注 @slimphp 以获取有关框架的新闻和更新。

作者

Slim 框架由 Josh Lockhart 创建和维护。Josh 是 New Media Campaigns 的资深网页开发者。Josh 还创建了并维护了 PHP: The Right Way,这是一个在 PHP 社区中流行的运动,旨在向新的 PHP 程序员介绍最佳实践和有用信息。

许可证

Slim 框架在 MIT 公共许可证下发布。

https://slim.php.ac.cn/license