README

安装方法

//使用中国镜像
composer config -g repo.packagist composer https://packagist.phpcomposer.com
//下载安装最新
composer require "hetao29/slightphp:^5.0.0"

主要特点

独有的"框架"与"plugins"分离方式，把核心框架与其它功能独立分开
支持命令行(cli)模式可以直接执行SlightPHP::run($path_info) ，可以用于WorkerMan,Swoole 等PHP 服务端项目
支持多级URI路由
支持传统的分隔符目录结构和按命令空间规划的目录结构(5.x版本支持)
支持自定义 “Controller”后缀
插件SDb，支持数据库读写库分离
插件SRoute 支持各种简洁路由支持，精简URL
插件STpl模板类，高效与灵活
其它更多灵活可定制的插件，请查看wiki或者samples下的例子

Hello, world!

第一步

在网站根目录下，建立index.php

<?php
//安装成功后
require_once("vendor/autoload.php");

SlightPHP::run();
?>

第二步

方案一（传统方法）

请在index.php所在目录下新建zone目录，在zone目录下新建page.page.php

<?php 
class zone_page{ 
    function PageEntry($inPath){
        echo "Hello, world!";
    } 
}

方案二（命令空间，5.x版本支持）

请在index.php所在目录下新建Zone目录，在Zone目录下新建PageController.php

<?php 
namespace Zone;
class PageController{ 
    function Entry($inPath){
        echo "Hello, world!";
    } 
}

第三步

请在你的地址栏里访问index.php，如

http://localhost/index.php

基本概念

zone 映射为一个目录名，默认为"zone"
page 映射为一个文件名，以.page.php为扩展名，默认为"page"
entry 映射为方法名，以Page开头的方法名，默认为"entry"
appDir 应用程序目录，默认为"."，就是当前目录
splitFlag 分割符，默认为"/"
inPath entry入口参数，数组，下面会有更详细的介绍

地址解析

这个地址 http://localhost/index.php 实际上和 http://localhost/index.php/zone/page/entry 一样会执行你的$appDir/zone/page.page.php下的pageEntry方法

你可以改变其默认规则

<?php
SlightPHP::setDefaultZone("user");
SlightPHP::setDefaultPage("profile");
SlightPHP::setDefaultEntry("update");
?>

当访问 http://localhost/index.php 时，就会执行 $appDir/user/profile.page.php里的pageUpdate方法，其实就是 http://localhost/index.php/user/profile/update 这个URL

多级路由

如下网址 http://localhost/user/info/edit/thumb 这样的会映射成如下2种方法

#文件名（$appDir/user/info/edit.page.php）
user_info_edit::pageThumb()

第二种（命令空间）

#文件名($appDir/User/Info/EditController.php)
#支持自定义 “Controller”后缀，用SlightPHP::setControllerSuffix("Action")之类的就行
User/Info/EditController::Thumb()

定义方法名前缀

支持自定义 HTTP_REQUEST_TYPE Http头类型，来自定义方法前缀，如果不设置，目录映射的方法名，默认前缀是 page，命令空间默认前缀为空

比如自定义HTTP_REQUEST_TYPE=ajax，则调用方法名为

function ajaxEntry()

高级地址解析-别名

如果加了这代码

SlightPHP::setZoneAlias("user","u");
SlightPHP::setPageAlias("profile","p");

你访问这个地址 http://localhost/index.php/u/p/update 和http://localhost/index.php/user/profile/update 会是一样的效果它的作用是增加user一个别名u

分隔符(splitFlag)

zone,page,entry的分隔默认是用/来分的，你可以改成自己想要的，如

SlightPHP::setSplitFlag(".")

就可以这样访问了 http://localhost/index.php/user.profile.update 或者更好看，加上.html http://localhost/index.php/user.profile.update.html 这样的方式你也可以这样,用多个分割符

SlightPHP::setSplitFlag("-.")

http://localhost/index.php/user-profile-update.html 和上面的是一样

Apache Rewrite

在你的.htaccess里或者apache的配置文件里加下类似代码

RewriteEngine   on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]

你就可以直接这样访问了 http://localhost/user/profile/update 如果你还加上了

SlightPHP::setSplitFlag(".");

那么就可以用这样的方式 http://localhost/user.profile.update

短路由

如你要直接这样，更短的地址 http://localhost/profile/update 请在apache的配置文件里加上类似这样的代码

RewriteRule   ^(/profile/.*)$ /index.php/user/profile/update/$1 [E=PATH_INFO:$1,L]

关于$inPath

$inPath[0] 就是当前的 zone的名字
$inPath[1] 就是当前的 page的名字
$inPath[2] 就是当前的 entry的名字
$inPath[...] 超过以前的就是后面更多的参数，如html

如 http://localhost/index.php/user/profile/update/other1/other2/... inPath是这样的 $inPath=array("user","profile","update","other1","other2","...")

appDir，程序目录设置

你可以自定义你的程序目录

SlightPHP::setAppDir("/home/www/myAppdir");

如http://localhost/index.php/user/profile/update

就会执行

/home/www/myAppdir/user/profile.page.php下的pageUpdate方法

建议你的appDir目录不要让外部访问到

插件导航

Wiki文档地址：https://github.com/hetao29/slightphp/tree/master/wiki
API文档地址：http://hetao29.github.io/slightphp/

STpl 模板插件 https://github.com/hetao29/slightphp/blob/master/wiki/STpl.md
SDb 数据库插件 https://github.com/hetao29/slightphp/blob/master/wiki/SDb.md

SRedis 缓存Redis插件 https://github.com/hetao29/slightphp/blob/master/wiki/SRedis.md
SConfig 配置文件插件 https://github.com/hetao29/slightphp/blob/master/wiki/SConfig.md
SRoute 路由插件 https://github.com/hetao29/slightphp/blob/master/wiki/SRoute.md
SError 错误插件 https://github.com/hetao29/slightphp/blob/master/wiki/SError.md
...

更多插件功能请看samples下的示例

Nginx配置

root /var/www/slightphp/samples/www;
location / {
	try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
	fastcgi_pass   127.0.0.1:9000;
	fastcgi_index  index.php;
	fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
	include        fastcgi_params;
}

Version

5.0.0

Free Software, MIT License!

hetao29 / slightphp

Package info

Security

Statistics