YZCloudBoot

Bootstrap for YZCloud PHP Application

Based on Slim Framework: http://www.slimframework.com/

安装

使用

目录结构

一个标准的基于 YZCloudBoot 的应用程序应该基本上是这样的结构

. |-- composer.json # 用户工程的 composer.json |-- config/ # 配置文件目录 | |-- env.php # 环境变量定义，主要定义 YZCLOUD_BOOT_APP_DIR 指定应用根目录 | |-- routes.php # 路由配置文件 | |-- beps.php # 业务扩展点配置文件 | |-- meps.php # 消息扩展点配置文件 | |-- src/ # 用户工程的源码 | |-- Bep # 业务扩展点实现 （可自定义） | |-- Mep # 消息扩展点实现 （可自定义） | |-- Controller # 控制器 （可自定义） | |-- ... # 其它用户工程的目录 | |-- templates/ # 模版文件目录 | |-- vendor/ # composer 三方组件目录 | |-- ... # 其它组件的目录 | |-- youzanyun | |-- yz-cloud-boot # 本框架所在目录 | |-- bin # 启/停脚本 | | |-- preload.sh # 服务启动前置脚本 | | |-- php_dev_server.sh # 开发服务器启动脚本 | | |-- daemon.php # 后台任务 | | | |-- public # Web Root 目录，Web 服务器需要以里面的 index.php 为默认页面 | | |-- index.php # 应用程序入口 | | | |-- src # 本框架的业务代码

Facade

实现了类似于 Laravel 的 Facade 特性，提供了可以迅速访问组件的绝大多数组件的静态代理

具体的命名空间位于 YouzanCloudBootFacades 中

目前包括：

SlimFramework 原生

有赞云框架专属

具体的类参考，可以参见每个类头部的 PHP Doc，在 PHPStorm 等 IDE 内可以识别 @method 并提供语法提示

依赖注入容器和默认组件

依赖注入使用了 SlimFramework 默认内建的 Pimple: https://pimple.symfony.com/

默认包含了所有 SlimFramework 的组件，可以参考: http://www.slimframework.com/docs/v3/concepts/di.html 的 Required services 章节

以下是我们这个框架中封装的组件：

<?php // @var YouzanCloudBootUtilEnvUtil $envUtil 环境访问实用工具 $envUtil = YouzanCloudBootFacadesDIFacade::get('envUtil'); // @var YouzanCloudBootUtilTokenUtil $tokenUtil Token工具 $tokenUtil = YouzanCloudBootFacadesDIFacade::get('tokenUtil'); // @var MonologLogger $logger 日志 $logger = YouzanCloudBootFacadesDIFacade::get('logger'); // @var YouzanCloudBootExtensionPointBepRegistry $bepRegistry 业务扩展点注册器 $bepRegistry = YouzanCloudBootFacadesDIFacade::get('bepRegistry'); // @var YouzanCloudBootExtensionPointTopicRegistry $mepRegistry 消息扩展点注册器 $mepRegistry = YouzanCloudBootFacadesDIFacade::get('mepRegistry'); // @var YouzanCloudBootUtilObjectBuilder $objectBuilder 反序列化辅助工具，将扩展点调用参数转换成匹配接口的对象 $objectBuilder = YouzanCloudBootFacadesDIFacade::get('objectBuilder'); // @var YouzanCloudBootStorePDOFactory $pdoFactory PDO 工厂，用于生成 PDO 实例 $pdoFactory = YouzanCloudBootFacadesDIFacade::get('pdoFactory'); // @var YouzanCloudBootStoreRedisFactory $redisFactory Redis 工厂，用于生成 Redis 实例 $redisFactory = YouzanCloudBootFacadesDIFacade::get('redisFactory'); // @var YouzanCloudBootHttpHttpClientWrapper $httpClient HTTP 客户端，进行了有赞云统一接出的封装以配合白名单机制 $httpClient = YouzanCloudBootFacadesDIFacade::get('httpClient'); // @var PDO $yzcMysql 连接有赞云上 MySQL 组件的 PDO 客户端，其采用的 MySQL 连接字符集为 utf8mb4，获得的 PDO 对象是 PHP 官方 PDO 对象 $yzcMysql = YouzanCloudBootFacadesDIFacade::get('yzcMysql'); // @var Redis $yzcRedis 连接有赞云上 Redis 组件的 Redis 客户端，获得的 Redis 对象是 php-redis 扩展提供的标准 Redis 对象 象 $yzcRedis = YouzanCloudBootFacadesDIFacade::get('yzcRedis');