使用 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 文件。首先测试系统捕获异常时的输出：

<?php
/*** Created by PhpStorm.* User: dee* Date: 2016/8/6* Time: 12:44*/
namespace Home\Controller;
use Think\Controller;class TestController extends Controller {public function index() {try {$this->division(10, 0);} catch(\Exception $e) {echo $e->getMessage();}}function division($dividend, $divisor) {if($divisor == 0) {throw new \Exception('Division by zero');}}
}

输出：

然后测试不加载 Whoops 组件，脚本遇到未捕获异常时的提示：

<?php
/*** Created by PhpStorm.* User: dee* Date: 2016/8/6* Time: 12:44*/
namespace Home\Controller;
use Think\Controller;class TestController extends Controller {public function index() {// 测试未捕获的异常$this->division(10, 0);}function division($dividend, $divisor) {if($divisor == 0) {throw new \Exception('Division by zero');}}
}

访问：http://127.0.0.3/php/composer/thinkphp/Home/Test

输出：

最后测试加载了 Whoops 组件，并且脚本遇到未捕获的异常时的输出：

<?php
/*** Created by PhpStorm.* User: dee* Date: 2016/8/6* Time: 12:44*/
namespace Home\Controller;
use Think\Controller;class TestController extends Controller {public function index() {// 使用composer自动加载器require $_SERVER['DOCUMENT_ROOT'].__ROOT__.'/vendor/autoload.php';// 设置Whoops提供的错误和异常处理$whoops = new \Whoops\Run;$whoops->pushHandler(new \Whoops\Handler\PrettyPageHandler);$whoops->register();// 测试未捕获的异常$this->division(10, 0);}function division($dividend, $divisor) {if($divisor == 0) {throw new \Exception('Division by zero');}}
}

输出：

测试结束。

附

安装组件的另一种方式

在 composer.json 文件中加入组件包：

例如添加组件 monolog

然后使用 composer update 命令下载组件

此时组件已经被安装到了项目中：

转载于:https://www.cnblogs.com/o-ye/p/6005520.html