入口文件

从v2.7开始在入口文件中可灵活配置各个目录组成,以下为一个标准的入口文件内容。

  1. <?php
  2. //应用入口
  3. use Cml\Cml;
  4. //定义项目根目录
  5. define('CML_PROJECT_PATH', dirname(__DIR__));
  6. //载入composer自动加载文件
  7. $loader = require '../vendor/autoload.php';
  8. //配置目录组成
  9. Cml::setApplicationDir([
  10. 'secure_src' => CML_PROJECT_PATH . DIRECTORY_SEPARATOR . 'proj3e9840c31203003edlxa75b4',
  11. 'app_config_path_name' => 'Config',//自动载入配置用
  12. 'app_lang_path_name' => 'Lang',//自动载入语言用
  13. 'app_view_path_name' => 'View',//渲染模板用
  14. 'app_controller_path_name' => 'Controller',//路由根据请求url映射控制器用
  15. 'app_static_path_name' => 'Resource', //静态资源目录名
  16. ]);
  17. //根据上面配置的目录,配置其它目录
  18. Cml::setApplicationDir([
  19. 'apps_path' => Cml::getApplicationDir('secure_src').'/Application',//应用存放目录其下可能有多个应用
  20. 'global_config_path' => Cml::getApplicationDir('secure_src').'/'.Cml::getApplicationDir('app_config_path_name'),//全局配置文件目录
  21. 'global_lang_path' => Cml::getApplicationDir('secure_src').'/'.Cml::getApplicationDir('app_lang_path_name'),//全局语言文件目录
  22. 'global_store_path' => Cml::getApplicationDir('secure_src').'/Runtime',//运行时文件目录
  23. 'runtime_cache_path' => Cml::getApplicationDir('secure_src').'/Runtime' . DIRECTORY_SEPARATOR . 'Cache',//运行时模板缓存 、文件缓存目录
  24. 'runtime_logs_path' => Cml::getApplicationDir('secure_src').'/Runtime' . DIRECTORY_SEPARATOR . 'Logs',//运行时日志文件目录
  25. ]);
  26. $loader->setPsr4('', Cml::getApplicationDir('apps_path'));
  27. //注入服务并运行应用
  28. //要注意的是这边只是做绑定并没有真正实例化
  29. Cml::runApp(function() {
  30. //必须绑定。系统错误及异常捕获机制 如果想使用第三方的服务只要简单封装一个服务。实现\Cml\Interfaces\ErrorOrException接口即可
  31. Cml::getContainer()->singleton('cml_error_or_exception', \Cml\ErrorOrException::class);
  32. //Cml::getContainer()->singleton('cml_error_or_exception', \Cml\Service\Whoops::class);//Whoops封装服务使用前请安装Whoops. composer require filp/whoops
  33. //必须绑定。环境解析。自带的服务实现development/product/cli三种。可以根据需要实现更多的环境
  34. Cml::getContainer()->singleton('cml_environment', \Cml\Service\Environment::class);
  35. //必须绑定。系统日志驱动 内置\Cml\Logger\File::class|\Cml\Logger\Redis::class两种.
  36. //自定义服务实现\Cml\Interfaces\Logger接口即可或继承\Cml\Logger\Base再按需重载
  37. Cml::getContainer()->singleton('cml_log', \Cml\Logger\File::class);
  38. //必须绑定。路由
  39. //框架自带的路由支持restful分格的路由、路由分组。 在未声明/未匹配到路由规则时会按url映射到文件的方式来执行相应的控制器方法。具体参考 http://doc.cmlphp.com/devintro/route/readme.html。
  40. //如果想使用第三方的路由只要简单封装一个服务。实现\Cml\Interfaces\Route接口即可
  41. Cml::getContainer()->singleton('cml_route', \Cml\Service\Route::class);
  42. //Cml::getContainer()->singleton('cml_route', \Cml\Service\FastRoute::class); //composer require nikic/fast-route
  43. //开发模式必须绑定。Debug调试信息
  44. //如果想使用第三方的调试台只要简单封装一个服务。实现\Cml\Interfaces\Debug接口即可/当然直接修改模板也可以。配置项 'debug_page' => CML_CORE_PATH.'/Tpl/debug.tpl', // debug调试信息模板
  45. Cml::getContainer()->singleton('cml_debug', \Cml\Debug::class);
  46. //可选,队列服务 内置 \Cml\Queue\Redis::class.(内置的redis服务与缓存挂钩)参考 http://doc.cmlphp.com/devintro/quenue.html
  47. //自定义服务实现\Cml\Interfaces\Queue接口即可或继承\Cml\Queue\Base再按需重载
  48. Cml::getContainer()->singleton('cml_queue', \Cml\Queue\Redis::class);
  49. //可选,锁服务 内置\Cml\Lock\File::class|\Cml\Lock\Redis::class|\Cml\Lock\Memcache::class三种.
  50. //内置的redis锁跟/memcache锁 跟缓存服务挂钩。参考 http://doc.cmlphp.com/devintro/lock.html
  51. //自定义服务实现\Cml\Interfaces\Lock接口即可或继承\Cml\Lock\Base再按需重载
  52. Cml::getContainer()->singleton('cml_lock', \Cml\Lock\Redis::class);
  53. //可选。绑定要用到视图引擎内置以下5种 以view_为前缀,用的时候不用带前缀如使用view_html视图服务: \Cml\View::getEngine('html');
  54. //\Cml\View::getEngine();不传类型的时候,使用的引擎可在配置文件中配置 'view_render_engine' => 'Html'默认为view_html
  55. //自定义服务实现\Cml\Interfaces\View接口即可或继承\Cml\View\Base再按需重载
  56. Cml::getContainer()->singleton('view_html', \Cml\View\Html::class);
  57. Cml::getContainer()->singleton('view_json', \Cml\View\Json::class);
  58. // Cml::getContainer()->singleton('view_blade', \Cml\Service\Blade::class); //blade模板引擎,使用前安装依赖。composer require linhecheng/cmlphp-ext-blade
  59. //Cml::getContainer()->singleton('view_excel', \Cml\View\Excel::class);
  60. //Cml::getContainer()->singleton('view_xml', \Cml\View\Xml::class);
  61. //可选,db 允许多种驱动同时使用。因同种数据库可能同时连多个.这边不使用单例绑定.内置 \Cml\Db\MySql\Pdo::class|\Cml\Db\MongoDB\MongoDB::class 两种数据库支持.
  62. //自定义数据库驱动实现\Cml\Interfaces\Db接口即可或继承\Cml\Db\Base再按需重载
  63. Cml::getContainer()->bind('db_mysql', \Cml\Db\MySql\Pdo::class);
  64. Cml::getContainer()->bind('db_mongodb', \Cml\Db\MongoDB\MongoDB::class);
  65. //可选,cache 允许多种驱动同时使用。如即使用memcache又使用redis.有使用数据库时至少要启用一种缓存,因同种缓存可能同时连多个.这边不使用单例绑定。
  66. // 内置 \Cml\Cache\Redis::class|\Cml\Cache\File::class | \Cml\Cache\Memcache::class | \Cml\Cache\Apc::class 四种缓存支持.
  67. //自定义缓存驱动实现\Cml\Interfaces\Cache接口即可或继承\Cml\Cache\Base再按需重载
  68. Cml::getContainer()->bind('cache_redis', \Cml\Cache\Redis::class);
  69. Cml::getContainer()->bind('cache_file', \Cml\Cache\File::class);
  70. //Cml::getContainer()->bind('cache_memcache', \Cml\Cache\Memcache::class);
  71. //Cml::getContainer()->bind('cache_apc', \Cml\Cache\Memcache::class);
  72. });

原文: http://doc.cmlphp.com/bootstrap.html