PHP中的自定义路由使用小结

本文由码农网澳门新浦京电子游戏 , –
曾钊泳原创翻译,转载请看清文末的转载要求,欢迎参与我们的付费投稿计划!

上一篇中我们已经建立了一个空的 Composer 项目,本篇将讲述如何构建路由。

简介

我手上有个用PHP写的网站,类似于个人测试性质的站点,我独立设计,在这过程中犯了所有可能的设计和编程上的错误,同时我也收获了很多,这也促使我去学习PHP和MySQL。每当我学习新的技术或web实践时,都会想到我的网站会从中得益。正如你可以想象到的,它的可读性不强。测试网站往往在代码可读性和可维护性方面表现糟糕,尤其当你仅仅因为某些必要的功能而学习一门编程语言时,而这也正是我一直以来学习PHP的方式。

自从了解了ASP.NET
MVC,我便思考如何在这个网站上实践这套MVC模式。我喜欢这整套概念的一切,尤其是路由。但我并不想为此而重构整个网站的现有框架,担心这样一来,大部分现有代码将变成像是异物一样,不受我的控制和理解。网站已经有一个WordPress搭建的博客,通过修改模板让它看起来就像是一个完整的站点,好比在一巨大的墙上画涂鸦一样,这简直是一团糟。

然后呢?刚不久前,我学习了一些REST
API的相关知识,这是为日常工作所需而学习的。有没有一个最佳的方式去学习这些呢?我知道有个网站会从中获益。在网上阅读了一些关于在PHP环境应用RESTful
API的文章,我了解了.htaccess文件。现在我知道怎样在PHP中搭建路由,因此,也许能在测试网站实施自己设计的小型的、简单的MVC模型。

久负盛名的 CodeIgniter 框架是很多人的 PHP
开发入门框架,同样也是我开始学习如何从头构建一个网站的框架。在 CI
中我学到了很多,其中对 MVC
的深入理解和对框架本质的理解对我的影响最大。从使用框架是为了提高开发效率的角度来看,框架的本质就是路由。

设想

在PHP中搭建自定义路由的关键在于增加一个.htaccess文件,以下请看

具体实现:

我在网站文件夹目录中新增了一个”API”文件夹,在里面新建一个.htaccess文件,内容是我从Corey
Maynard写的一段文本中参考来的。

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?request=$1 [QSA,NC,L]
</IfModule>

长话短说,有了这个配置,所有以”www.yoursite.com/api/”开头或指向不存在的文件或路径的请求都会被重定向到index.php文件。$1变量值表示请求的URL地址,”request”变量名也很好理解,用$_REQUEST[‘request’]命令就可轻易获取。

另外,index.php文件和.htaccess文件在同一访问层级。

下面我们就开始自己来构建路由,先去 GitHub 搜一下:点此查看搜索结果

可能出现的问题?

事实上,你可能还没启用指定的module。

在WampServer环境下,我需要启用相应module来支持本机运行。一种方法是点击托盘图标进入”Apache”目录,在”Apache
modules”列表中选中rewrite_module,然后重启所有服务。另一种方法是编辑httpd.conf文件,取消下面这段配置的注释

#LoadModule rewrite_module modules/mod_rewrite.so

我想接下来要做的事情之一就是给网站做几个自测网页,好让我确定网站的负责人没有改变任何东西。这听起来可能有点偏执和可笑,但又一次,我需要临时增加
“set names latin2;”配置来检视数据库导入的数据。

如果想验证以上配置是否在服务器上启用,你可以使用这段代码:

echo in_array('mod_rewrite', apache_get_modules());

推荐 Composer
包为codingbean/macaw ,作者应该是在 GitHub
上改名了,这可能会造成一定的困扰。下面开始安装 Macaw 包,更改
composer.json:

接下来呢?

至此我获得一些重要的知识,让我可以为我的网站搭建新的MVC框架。使用新框架比使用现有解决方案更棒,很大程度上由于这让我在应用MVC模式的过程中获得广泛的知识。由于所有代码都是我个人的工作量,也就没有任何消耗性组件。

继续为我的网站创建REST
API。现在我才能实质性地将数据库逻辑从网页界面中抽离出来。

{ "require": {  "codingbean/macaw": "dev-master" }}

有用的链接

如果你想知道我是怎样找到解决方案,那下面是我从中获得知识的网站 

运行 composer update,成功之后将得到以下目录:

澳门新浦京电子游戏 1

至此,Macaw 包安装成功!

下面,就是见证奇迹的时刻!我们将赋予 MFFC 生命力,让它真正地跑起来!

新建 MFFC/public
文件夹,这个文件夹将是用户唯一可见的部分。在文件夹下新建 index.php
文件:

<?php// Autoload 自动载入require '../vendor/autoload.php';// 路由配置require '../config/routes.php';

上面一行表示引入 Composer
的自动载入功能,下面一行表示载入路由配置文件。新建 MFFC/config
文件夹,在里面新建 routs.php 文件,内容如下:

<?phpuse NoahBuscherMacawMacaw;Macaw::get('fuck', function() { echo "成功!";});Macaw::get('(:all)', function($fu) { echo '未匹配到路由<br>'.$fu;});Macaw::dispatch();

Macaw 的文档位于 HTTP
服务软件类型自行设置伪静态,其实跟绝大多数框架一样:
将所有非静态文件全部指向 index.php 。

然后,将某一个端口用 Apache 或 Nginx 分配给 MFFC/public
目录,这一步十分建议用 Apache 或者 Nginx 做。

如果使用 PHP 内置 HTTP 服务器:

cd public && php -S 127.0.0.1:3000

将导致路由的Macaw::get(‘fuck’ 必须写成Macaw::get(‘/fuck’ 才能响应。

目前的代码使用 Apache + mod_php 和 Nginx + php-fpm 方式均没有问题。

我在本地绑定了 81 端口,访问 可以看到:

澳门新浦京电子游戏 2

如果页面乱码,请调整编码为
UTF-8。如果你成功看到以上页面,那么恭喜你,路由配置成功!

Macaw
只有一个文件,去除空行总共也就一百行多一点,通过代码我们能直接看明白它是怎么工作的。下面我简略分析一下:

  1. Composer 的自动加载在每次 URL 驱动 MFFC/public/index.php
    之后会在内存中维护一个全量命名空间类名到文件名的数组,这样当我们在代码中使用某个类的时候,将自动载入该类所在的文件。

  2. 我们在路由文件中载入了 Macaw 类: use NoahBuscherMacawMacaw;
    ,接着调用了两次静态方法
    ::get(),这个方法是不存在的,将由MFFC/vendor/codingbean/macaw/Macaw.php
    中的__callstatic() 接管。

  3. 这个函数接受两个参数,$method 和 $params,前者是具体的 function
    名称,在这里就是 get,后者是这次调用传递的参数,即
    Macaw::get(‘fuck’,function(){…})
    中的两个参数。第一个参数是我们想要监听的 URL 值,第二个参数是一个 PHP
    闭包,作为回调,代表 URL 匹配成功后我们想要做的事情。

4.__callstatic() 做的事情也很简单,分别将目标URL(即
/fuck)、HTTP方法(即 GET)和回调代码压入$routes、$methods 和$callbacks
三个 Macaw 类的静态成员变量(数组)中。

  1. 路由文件最后一行的Macaw::dispatch(); 方法才是真正处理当前 URL
    的地方。能直接匹配到的会直接调用回调,不能直接匹配到的将利用正则进行匹配。

发表评论

电子邮件地址不会被公开。 必填项已用*标注