本章我们会讲解伪静态的配置,还有URL构造的方法等相关内容。
新版的sp框架,伪静态功能是内置支持的。
在不到80行代码里面,实现了功能强大的php伪静态路由功能。(包括伪静态路由和url产生) 精简的代码带来非常高的执行效率,对比旧版的UrlRewrite扩展速度上有三倍的提升。
当然,旧版框架对比其他大型PHP框架的伪静态已经非常轻量级和快速了。
- 支持moduels多模块。
- 支持URL和参数定制。
- 支持http开头的域名适配,对跨站构造URL有良好的支持。
- 支持泛域名适配,如 *.example.com 的适配。
- 规则更简单,更直观,更容易配置了。
- 通过url()函数即可构造URL地址。
一般初学者使用伪静态时,首先遇到的问题是产生“404找不到页面”的情况。这情况通常都是因为没有正确配置服务器的原因。
接下来我们介绍一下较为常见的服务器的伪静态配置方法。
Apache
在默认情况下,sp框架在程序根目录已经自带.htaccess文件,该文件在Apache服务器下面是自动加载并且已经完成配置的。
根目录的.htaccess文件内容是:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php [L]
</IfModule>
注意,有时候我们会发现Apache服务器即使已经有了.htaccess文件,但是还是会发生404的情况,这样就需要检查一下Apache本身的配置是否开启“文件配置”的选项了。
-
找到httpd.conf文件,一般windows在apache/conf/httpd.conf目录里面,linux在/etc/httpd/conf/httpd.conf。
-
打开并且搜索到您的web根目录配置。如:
<Directory "/var/www/html"> AllowOverride None </Directory>
改为
<Directory "/var/www/html"> AllowOverride All </Directory>
主要是修改AllowOverride的值,AllowOverride意思是:是否能通过.htaccess文件配置来覆盖httpd.conf的配置。
-
检查以下语句前面有没有#号,有的话去掉#。如果无法找到该行配置,则在httpd.conf文件最后增加。
LoadModule rewrite_module modules/mod_rewrite.so
-
重启Apache即可。
Nginx
Nginx现在非常流行,大多数时候已经替代了Apache的地位。
Nginx需要配置当前站点的配置文件,如下:
location / {
if (!-e $request_filename){
rewrite (.*) /index.php;
}
}
location ^~ /protected {
deny all;
}
一般当前站点的配置文件会存储在/etc/nginx/sites-available/目录下面,以站点域名为名称的conf文件。
新浪SAE平台
config.yaml是SAE的配置文件,以下是伪静态的实例:
name: speedweb
version: 3
handle:
- rewrite: if (!-d && !-f) goto "/index.php?%{QUERY_STRING}"
- hostaccess: if (%{REQUEST_URI} ~ "/protected/") deny "all"
sp框架的伪静态配置,在protected/config.php文件里面,大概是这样:
$config = array(
'rewrite' => array(
'admin/index.html' => 'admin/main/index',
'admin/<c>_<a>.html' => 'admin/<c>/<a>',
'<c>/<a>' => '<c>/<a>',
'/' => 'main/index',
),
);
这里rewrite数组,就是我们的伪静态配置,可以看到,左边key值是URL地址,而右边是指向的modules/controller/action(当然没有modules也行)。
如果需要关闭rewrite,可以设置'rewrite' => null,那么全部URL都会变成原来的“/index.php?m=模块&c=控制器&a=方法&参数名=参数值”的形式。
我们来了解几个规则,非常简单:
- <m><c><a>分别指代modules,controller,action。
- 其他的<单词>,都是_GET的参数名称。
- 越是明确指向的URL配置,越要放前面。比如说'admin/index.html',要放在'admin/<c>_<a>.html'的前面,因为'admin/index.html'是明确的。而'<c>/<a>'和'/'就被放到最后了。
- 如果是'admin/<c>_<a>.html'和'admin/<c>_<a>_<username>.html',那么就应该是'admin/<c>_<a>_<username>.html'在前面,因为它更明确指向有参数username的地址。
我们来看看各种配置对应表:
类型 | 配置 | 实现URL | 指向控制器/方法(或 模块/控制器/方法) | GET参数 |
---|---|---|---|---|
固定URL | 'index.html' => 'main/index' | /index.html | main/index | - |
固定URL | '123.json' => 'view/number' | /123.json | view/number | - |
固定URL | 'admin/index.html' => 'admin/main/index' | /admin/index.html | admin/main/index | - |
使用<c>,<a> | '<c>_<a>.html' => '<c>/<a>' | /控制器_方法.html | 控制器/方法 | - |
使用<m>,<c>,<a> | '<m>/<c>_<a>.html' => '<m>/<c>/<a>' | /模块/控制器_方法.html | 模块/控制器/方法 | - |
使用<m>,<c>,<a>,固定部分URL | 'user-<a>.html' => 'user/<a>' | /user-方法.html | user/方法 | - |
使用参数 | 'blog-<id>.do' => 'user/blog' | /blog-9527.do | user/blog | arg("id") = 9527 |
使用参数 | 'admin/user/<username>' => 'admin/user/detail' | /admin/user/jake | admin/user/detail | arg("username") = "jake" |
使用参数 | 'u/<uid>/album.html' => 'user/album', | /u/123/album.html | user/album | arg("uid") = 123 |
使用参数 | 'page-<username>/<tid>' => 'page/view', | /page-jake/10086 | page/view | arg("username") = 'jake',arg("tid") = 10086 |
泛域名 | 'http://<username>.speedphp.com/' => 'main/index' | http://jake.speedphp.com | main/index | arg("username") = 'jake' |
泛域名 | 'http://<shopname>.shop.speedphp.com/article-<id>.html' => 'article/show' | http://ak47.shop.speedphp.com/article-520.html | article/show | arg("shopname") = 'ak47',arg("id") = 520 |
当配置好上述的规则后,我们可以通过url()函数,来生成URL地址。
url()函数有三个参数:$c, $a, $param
- $c参数是控制器名称,对应到protected/controller目录下面的controller类,如果用到modules模块开发,那么参数值是“模块名/控制器名”。对应该模块目录下的controller类。
- $a参数是方法名称。对应controller类里面的,带action前缀的方法。
- $param是参数数组,键是参数名称,值是参数值。
在没有伪静态的时候:
不设置伪静态就是配置:'rewrite' => null
类型 | 控制器内使用url()函数 | 模板内使用 | 显示结果 |
---|---|---|---|
进入控制器/方法 | url("view", "index"); | <{url c="view" a="index"}> | /index.php?c=view&a=index |
进入模块/控制器/方法 | url("admin/view", "index"); | <{url c="admin/view" a="index"}> | /index.php?m=admin&c=view&a=index |
带参数 | url("view", "index", array("page" => 100)); | <{url c="view" a="index" page="100"}> | /index.php?c=view&a=index&page=100 |
带参数 | url("admin/view", "index", array("page" => 100, "sort" => "desc")); | <{url c="admin/view" a="index" page="100" sort="desc"}> | /index.php?m=admin&c=view&a=index&page=100&sort=desc |
在开启伪静态之后:
开启伪静态之后,会根据rewrite配置而定URL的生成方式。
配置 | 控制器内使用url()函数 | 模板内使用 | 显示结果 | 指向控制器/方法(或 模块/控制器/方法) | GET参数 |
---|---|---|---|---|---|
'index.html' => 'main/index' | url("main", "index"); | <{url c="main" a="index"}> | /index.html | main/index | - |
'123.json' => 'view/number' | url("view", "number"); | <{url c="view" a="number"}> | /123.json | view/number | - |
'admin/index.html' => 'admin/main/index' | url("admin/main", "index"); | <{url c="admin/main" a="index"}> | /admin/index.html | admin/main/index | - |
'<c>_<a>.html' => '<c>/<a>' | url("mycontrol", "myaction"); | <{url c="mycontrol" a="myaction"}> | /mycontrol_myaction.html | mycontrol/myaction | - |
'<m>/<c>_<a>.html' => '<m>/<c>/<a>' | url("mod/mycontrol", "myaction"); | <{url c="mod/mycontrol" a="myaction"}> | /mod/mycontrol_myaction.html | mod/mycontrol/myaction | - |
'user-<a>.html' => 'user/<a>' | url("user", "myaction"); | <{url c="user" a="myaction"}> | /user-myaction.html | user/myaction | - |
'blog-<id>.do' => 'user/blog' | url("user", "blog", array("id"=>9527)); | <{url c="user" a="blog" id="9527"}> | /blog-9527.do | user/blog | arg("id") = 9527 |
'blog-<id>.do' => 'user/blog' | url("user", "blog", array("page"=>2, "id"=>9527)); | <{url c="user" a="blog" page="2" id="9527"}> | /blog-9527.do**?page=2** | user/blog | arg("id") = 9527, arg("page") = 2 |
'admin/user/<username>' => 'admin/user/detail' | url("admin/user", "detail", array("username"=>"jake")); | <{url c="admin/user" a="detail" username="jake"}> | /admin/user/jake | admin/user/detail | arg("username") = "jake" |
'u/<uid>/album.html' => 'user/album', | url("user", "album", array("uid"=>123)); | <{url c="user" a="album" uid="123"}> | /u/123/album.html | user/album | arg("uid") = 123 |
'u/<uid>/album.html' => 'user/album', | url("user", "album", array("uid"=>123, "sort"=>"2")); | <{url c="user" a="album" uid="123" sort="2"}> | /u/123/album.html?sort=2 | user/album | arg("uid") = 123, arg("sort") = 2 |
'page-<username>/<tid>' => 'page/view', | url("page", "view", array("username"=>"jake", "tid"=>"10086")); | <{url c="user" a="album" username="jake" tid="10086"}> | /page-jake/10086 | page/view | arg("username") = 'jake',arg("tid") = 10086 |
'http://<username>.speedphp.com/' => 'main/index' | url("main", "index", array("username"=>"jake")); | <{url c="main" a="index" username="jake"}> | http://jake.speedphp.com | main/index | arg("username") = 'jake' |
'http://<shopname>.shop.speedphp.com/article-<id>.html' =>'article/show' | url("article", "showindex", array("shopname"=>"ak47", "id"=>520)); | <{url c="article" a="show" shopname="ak47" id="520"}> | http://ak47.shop.speedphp.com/article-520.html | article/show | arg("shopname") = 'ak47',arg("id") = 520 |
'http://<shopname>.shop.speedphp.com/article-<id>.html' =>'article/show' | url("article", "showindex", array("shopname"=>"ak47", "id"=>520, "page"=>2)); | <{url c="article" a="show" shopname="ak47" id="520" page="2"}> | http://ak47.shop.speedphp.com/article-520.html?page=2 | article/show | arg("shopname") = 'ak47',arg("id") = 520, arg("page") = 2 |
这里注意两个问题:
- 比配置多出来的参数,那么会以?参数名=参数值的方式跟在URL后面。上表应该可以看得出来。
- 如果发现取得的URL不是想要的,可以调整一下rewrite配置规则的前后顺序,多几次调整就会正确,并且找到规律。