README

Cek Ongkos Kirim (Slim+ RajaOngkir)

安装

使用 composer 安装最新版本。

$ composer create-project --no-interaction --stability=dev zhiephie/slim-rajaongkir app

Slim 框架

Slim 是一个 PHP 微型框架，帮助您快速编写简单而强大的 Web 应用程序和 API。Slim 对初学者和专业人员都易于使用。Slim 倾向于简洁而非简短，倾向于常见情况而非边缘情况。其接口简单、直观，并且有广泛的文档，既有在线文档，也有代码本身中的文档。感谢您选择 Slim 框架作为您的下一个项目。我相信您会喜欢它的。

特性

强大的路由器
- 标准和自定义 HTTP 方法
- 带有通配符和条件的路由参数
- 路由重定向、终止和传递
- 路由中间件
资源定位器和 DI 容器
带有自定义视图的模板渲染
闪存消息
加密 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

确保 .htaccess 和 index.php 文件位于同一公开可访问的目录中。该 .htaccess 文件应包含此代码

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

此外，请确保您的虚拟主机已配置为具有 AllowOverride 选项，以便可以使用 .htaccess 重写规则

AllowOverride All

Nginx

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

try_files $uri $uri/ /index.php?$args;

这假设 Slim 的 index.php 位于您项目的根目录中（www 根）。

HipHop 虚拟机 for PHP

您的 HipHop 虚拟机配置文件应包含此代码（以及其他您可能需要的设置）。请确保将 ServerRoot 设置更改为指向您的 Slim 应用程序的文档根目录。

Server {
    SourceRoot = /path/to/public/directory
}

ServerVariables {
    SCRIPT_NAME = /index.php
}

VirtualHost {
    * {
        Pattern = .*
        RewriteRules {
                * {
                        pattern = ^(.*)$
                        to = index.php/$1
                        qsa = true
                }
        }
    }
}

lighttpd

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

url.rewrite-if-not-file = ("(.*)" => "/index.php/$0")

这假设 Slim 的 index.php 位于您项目的根目录中（www 根）。

IIS

确保 Web.config 和 index.php 文件位于同一公开可访问的目录中。该 Web.config 文件应包含此代码

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="slim" patternSyntax="Wildcard">
                    <match url="*" />
                    <conditions>
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="index.php" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

Google App Engine

要成功在 Google App Engine 上运行您的 Slim 应用程序，需要两个步骤。首先，确保 app.yaml 文件包含一个默认处理程序到 index.php

application: your-app-name
version: 1
runtime: php
api_version: 1

handlers:
# ...
- url: /.*
  script: public_html/index.php

接下来，编辑您的 index.php 文件，以便 Slim 了解传入的 URI

$app = new Slim();

// Google App Engine doesn't set $_SERVER['PATH_INFO']
$app->environment['PATH_INFO'] = $_SERVER['REQUEST_URI'];

// ...
$app->run();

文档

http://docs.slimframework.com/

如何贡献

注意：我们只接受 Slim 2（master 分支）的安全修复。所有开发都集中在 Slim 3（develop 分支）上。

拉取请求

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

将新功能或改进分开到单独的功能分支，并为每个分支发送拉取请求非常重要。这使我能够分别审查和合并新功能或改进。

风格指南

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

单元测试

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

了解PHPUnit

社区

论坛和知识库

访问Slim的官方网站和知识库http://help.slimframework.com，在这里您可以找到公告，与Slim用户聊天，提问，帮助他人，或者展示您酷炫的Slim框架应用。

Twitter

关注Twitter上的@slimphp，获取框架的新闻和更新。

作者

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

许可证

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

https://github.com/slimphp/Slim/blob/master/LICENSE

zhiephie / slim-rajaongkir

维护者

详细信息