使用 Composer 为 ThinkPHP(3.2.3)框架添加和管理组件
环境:Windows 10 64位 PHP 版本:5.5.12 框架:ThinkPHP 3.2.3
Tips:
组件:打包的代码,可以是一系列相关的类(class)、接口(interface)、特性(trait),用于解决某个具体的问题。组件中的类、接口、特性通常放在同一个命名空间中。
Packagist:https://packagist.org/,该网站收集 PHP 组件,可以在上面查找项目中需要的组件。ThinkPHP 在该站的地址为:https://packagist.org/packages/topthink/thinkphp
Composer:Composer 是 PHP 组件的依赖管理器,在命令行中运行,通过运行命令可以下载组件(以及组件的依赖)并且把组件(以及组件的依赖)自动加载到项目中。
安装 Composer
Composer 官网地址:https://getcomposer.org/,中文镜像地址:http://www.phpcomposer.com/
Windows 版下载地址:https://getcomposer.org/download/
下载安装包并安装:
如果安装不成功且提示:
The openssl extension is missing, which will reduce the security and stability of Composer. If possible you should enable it or recompile php with --with-openssl
则需要将 php.ini 中 extension=php_openssl.dll 前面的注释取消。
当安装成功后,程序会自动关把安装路径添加到系统的环境变量,打开环境变量可以看到:
因此在 cmd 命令提示符下可以直接执行 composer 命令:
如果看到这个画面则说明安装成功了。
准备框架
测试使用 ThinkPHP(3.2.3) 框架(也可以使用 Laravel、Yii 等其他现代框架)。初始化的框架根目录中,有一个 composer.json 文件:
{ "name": "topthink/thinkphp", "description": "the ThinkPHP Framework", "type": "framework", "keywords": ["framework","thinkphp","ORM"], "homepage": "http://thinkphp.cn/", "license": "Apache2", "authors": [ { "name": "liu21st", "email": "liu21st@gmail.com" } ], "require": { "php": ">=5.3.0" }, "minimum-stability": "dev" }
PHP 组件中必须要有 composer.json 文件。Composer 会使用该文件中的信息查找、安装和自动加载 PHP 组件。
其中:
name 表示该组件的 厂商名(最顶层命名空间)和包名(字命名空间),格式是 "name": "vendor/package",vendor 表示最顶层命名空间,package 表示字命名空间
require 表示该组件依赖的组件
一会安装了其他组件之后可以看看该文件的变化。
安装组件
在 ThinkPHP 项目中安装一个错误与异常的组件 Whoops,地址:https://packagist.org/packages/filp/whoops
项目下的 composer require filp/whoops 就是该组件在 Composer 下的安装命令。
该组件的作用是如果 PHP 脚本中触发了错误和没有捕获的异常,则出现 Whoops 的诊断页面。
在命令提示符下进入项目目录:
执行命令 composer require filp/whoops
看到以上提示说明组件安装完成,此时查看项目目录,发现在根目录下会多一个 vendor 目录:
组件 Whoops 就位于 Vendor/filp 目录下。
此时再看根目录下 composer.json 文件:
项目的依赖组件中多了 Whoops 组件,版本是 2.1
测试组件
在 Application/Home/Controller 下创建 TestController.class.php 文件。首先测试系统捕获异常时的输出:
按 Ctrl+C 复制代码
按 Ctrl+C 复制代码
输出:
然后测试不加载 Whoops 组件,脚本遇到未捕获异常时的提示:
按 Ctrl+C 复制代码
按 Ctrl+C 复制代码
访问:http://127.0.0.3/php/composer/thinkphp/Home/Test
输出:
最后测试加载了 Whoops 组件,并且脚本遇到未捕获的异常时的输出:
按 Ctrl+C 复制代码
按 Ctrl+C 复制代码
输出:
测试结束。
附
安装组件的另一种方式
在 composer.json 文件中加入组件包:
例如添加组件 monolog
然后使用 composer update 命令下载组件
此时组件已经被安装到了项目中: