利用 Composer 一步一步构建自己的 PHP 框架(二)——构建路由

2014-10-13   /   阅读数:63968   /   分类: PHP

本教程示例代码见 https://github.com/johnlui/My-First-Framework-based-on-Composer


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


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


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


推荐 https://github.com/NoahBuscher/Macaw,对应的 Composer 包为 noahbuscher/macaw 。

下面开始安装它,更改 composer.json:

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

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


QQ20141013-2.jpg

至此,Macaw 包安装成功!


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


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

<?php

// Autoload 自动载入
require '../vendor/autoload.php';

// 路由配置
require '../config/routes.php';


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

<?php

use NoahBuscher\Macaw\Macaw;

Macaw::get('fuck', function() {
  echo "成功!";
});

Macaw::get('(:all)', function($fu) {
  echo '未匹配到路由<br>'.$fu;
});

Macaw::dispatch();


Macaw 的文档位于 https://github.com/NoahBuscher/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 端口,访问 http://127.0.0.1:81/fuck 可以看到:

Image

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


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

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

2. 我们在路由文件中载入了 Macaw 类:“use NoahBuscher\Macaw\Macaw;”,接着调用了两次静态方法 ::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 类的静态成员变量(数组)中。

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


下一步:利用 Composer 一步一步构建自己的 PHP 框架(三)——设计 MVC

WRITTEN BY

avatar

评论:

老魏
2018-01-03 17:59
大佬 引入的 config文件和新建的名字你没写成一样的

require '../config/routes.php';

新建 MFFC/config 文件夹,在里面新建 routs.php 文件[
北落师门
2018-01-03 13:46
phpstudy环境下开发,照着博客会出现访问不到的问题。最终解决办法,

Macaw::get('/index.php/fuck',function(){
    echo "出来吧,神龙!!!";
});

访问网址  http://127.0.0.1:1002/index.php/fuck
蒋勇
2017-12-05 19:02
很不错的文章
杀不死
2017-07-12 17:14
为什么我也是 。直接输入localhost:81 , 进入 all  ,输入localhost:81/index.php   进入all  , 输入 localhost:81/index.php/fuck
可以显示成功    ,但  localhost:81/fuck   就是 404  。。 搞一整天了 还没弄明白
JohnLui
2017-07-12 18:01
@杀不死:没设置伪静态
moming
2017-05-12 14:35
请问一下该操作是需要PHP7.0以上的版本才能运行吗?我的是PHP5.6的,运行composer update的时候,下载下来的文件夹是nbproject里面还有private文件夹 project.properties和project.xml这些,这是怎么一回事呢?
JohnLui
2017-07-12 18:02
@moming:那是以内你用 NetBeans 打开过,它自己生成的配置文件。。。
hawaker
2017-05-08 17:36
没讲到rewrite啊
菜鸟
2016-12-24 20:46
Macaw 这个完全看不懂 不懂路由啊
对对对
2016-12-24 19:57
大神,那路由老阻挡css,介绍引入,我集成的是smarty模板引擎
qwer
2016-12-22 15:03
为什么我的两个都输出来了
成功!未匹配到路由
fuck
羽凡
2016-12-28 14:19
@qwer:Macaw::haltOnMatch();
Macaw::dispatch();少了行代码
phper
2017-09-24 21:25
@羽凡:少那行dispatch()的话,不是应该什么也不显示吗?可qwer说两种结果都显示出来了。
amz
2016-10-29 15:24
写的不错,简洁明了。
菜鸟1号
2016-08-15 13:35
您好

http://localhost/public/ 这样是可以访问的

http://localhost/public/fuck 久报404错误 啦  我用的是nginx 到底是啥原因呢 怎么处理这个问题呢
raphaelsoul
2016-07-06 11:20
这里有个坑,折腾了我一下,使用内置服务器(php -S 127.0.0.1:8888)的时候因为没有rewrite的关系,需要在URL里面加上index.php才行,比如localhost:8888/index.php/fuck才可以正常访问。当然如果是nginx或者Apache,配置好了就不需要了。看老师的这系列文章学到不少,感谢。
海盗
2017-06-12 11:26
@raphaelsoul: index .....真是个坑/ 多谢了
鱼摆摆
2016-05-21 15:11
NGINX下成功和未匹配到路由都出现了,请问是怎么回事呢
server {
    listen       8088;
    server_name  localhost;
    root    D:/nginx/html/MFFC/public;

    autoindex off;

    location / {
        try_files $uri $uri/ /index.php?/$uri;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   html;
    }
  
    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;
    }
}
而我却
2016-05-20 15:58
laravel  composer安装缩略图
D:\phpStudy\WWW\laravel>composer update
> php artisan clear-compiled
Loading composer repositories with package information
Updating dependencies (including require-dev)
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Installation request for intervention/image 2.0.15 -> satisfiable by inter
vention/image[2.0.15].
    - intervention/image 2.0.15 requires ext-fileinfo * -> the requested PHP ext
ension fileinfo is missing from your system.

  To enable extensions, verify that they are enabled in those .ini files:
    - D:\phpStudy\php55\php.ini
  You can also run `php --ini` inside terminal to see which files are used by PH
P in CLI mode.
aa
2016-06-12 13:42
@而我却:你解决了吗,这个问题
apsana
2016-03-08 22:30
按你说的做,composer  连不上github 我手动下载包 解压到vendor目录但是
引入autoload.php后 用  use  xxxx ;初始化类时说  找不到类
为什么?
手动下载不行么,怎么能自动载入
鬼国二少
2015-12-15 22:21
大侠,我按照你的配置做了,但是 http://mffc.mysoft.cn/index.php/fuck这样访问 500 错误。 我是指向了 public 目录的 并且 我单独在 index.php 打印东西时可以的,为什么我这儿就不行呢。初学composer,不懂具体怎么用!
LAU
2015-12-28 17:25
@鬼国二少:macaw文件夹下有个.htaccess文件,将它拷贝到public文件夹内
jenchih
2016-06-23 02:09
@鬼国二少:我也是,一直访问都是404 ,
Macaw::get('fuck', function() {
  echo "成功!";
});

Macaw::get('/', function() {  
  echo 'Hello world!';
});
Macaw::get('/aa', function() {  
  echo 'aa';
});

Macaw::get('(:all)', function($fu) {
  echo '未匹配到路由<br>'.$fu;
});

打开  我自己配置的域名 jenchih.com   显示为匹配到路由
如果打开 jenchih.com/index.php  就显示 为匹配到路由 index.php
加上/fuck   什么的 都是404 - -?
mr.lan
2015-11-24 00:31
大神,我按照你提供的思路,到了composer路由的时候,没有composer你建议的组件,而是弄了个最火的chriso/klein.php。然后不知道怎么用这个去设置访问我写的控制器下的某个方法。求大神帮忙研究下
JohnLui
2015-11-24 00:38
@mr.lan:建议自己研究
mr.lan
2015-11-24 00:39
@JohnLui:关键一点都看不懂,我有好好看的,研究了老半天了。
JohnLui
2015-11-24 00:40
@mr.lan:一点看不懂就先别自己造框架了吧
mr.lan
2015-11-24 00:41
@JohnLui:嗯,太激进了点。谢了大神。
寞踪
2015-09-16 17:48
Macaw 路由得根据代理环境自己改改,不然没法用!
tsh
2015-08-21 14:43
Warning: preg_match(): Compilation failed: unmatched parentheses at offset 5 in D:\MFFC\vendor\NoahBuscher\macaw\Macaw.php on line 117
404  
大神出现了这个问题该怎样解决呢
JohnLui
2015-08-22 13:58
@tsh: 你改了这个文件?目测是语法错误。。。
tsh
2015-08-24 09:10
@JohnLui:没有改过文件
darren
2015-09-16 13:51
@tsh:我在win7+phpstudy+php5.5的集成环境下也遇到了这个问题,我是这样逐步解决的:
1. 先把routes.php的
Macaw::get('fuck',function(){
    echo 'fuck';
});

Macaw::get('(:all)', function($fu) {
    echo 'not match route</br>'.$fu;
});

替换为:
Macaw::get('/fuck',function(){
    echo 'fuck';
});

Macaw::get('/(:all)', function($fu) {
    echo 'not match route</br>'.$fu;
});
这时报错没有了,但是访问 /fuck路径时 ‘not match route’ 字符串也会输出;

2. 根据站长发布的TinyLara框架的TinyRouter.php 文件,把 vendor/noahbuscher/macaw/Macaw.php 文件做了调整:

      __callstatic($method, $params) 方法中,  $uri = $params[0];;
    dispatch() 方法中: $uri = self::detect_uri();
   添加了
    private static function detect_uri()
    {
        $uri = $_SERVER['REQUEST_URI'];
        if (strpos($uri, $_SERVER['SCRIPT_NAME']) === 0) {
            $uri = substr($uri, strlen($_SERVER['SCRIPT_NAME']));
        } elseif (strpos($uri, dirname($_SERVER['SCRIPT_NAME'])) === 0) {
            $uri = substr($uri, strlen(dirname($_SERVER['SCRIPT_NAME'])));
        }
        if ($uri == '/' || empty($uri)) {
            return '/';
        }
        $uri = parse_url($uri, PHP_URL_PATH);
        return str_replace(array('//', '../'), '/', trim($uri, '/'));
    }
这时routes.php文件中的路由:

Macaw::get('fuck',function(){
    echo 'success';
});

Macaw::get('(:all)', function($fu) {
    echo 'not match route</br>'.$fu;
});
访问正常了,不用添加  ‘/ ’  了
Kenny
2015-11-24 12:54
@darren:Macaw处理URL的时候好像是有问题
鬼国二少
2015-12-15 22:49
@darren:6666,根据这个指示成功了!
peiwen
2015-08-20 18:06
大神,打印__callstatic 中的  $uri = dirname($_SERVER['PHP_SELF']).$params[0];   是带 index.php的 类似这样:比如我配置路由是Macaw::get('/IMG',function(){
    echo 'Img server';
});
那 $uri =   /index.php/foo
我是开启apache重写的, .htaccess文件内容如下
<IfModule mod_rewrite.c>
  Options +FollowSymlinks
  RewriteEngine On

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

如果我访问的路径是  myhost.com/foo ,   那么Macaw 中dispatch  里 $uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);   这里的$uri = /foo , 这就导致 没法匹配到路由 (因为上面实际是 index.php/foo)
是因为我的重写有问题吗?  (Apache/2.4.4 (Win32) PHP/5.4.16)
JohnLui
2015-08-22 13:55
@peiwen:https://github.com/TinyLara/TinyRouter/blob/master/TinyRouter.php 参考这个文件,这里解决了子目录和第一个 / 的问题。

发表评论:

© 2011-2018 岁寒  |  Powered by Emlog