账户中心 退出系统
开发文档 资讯·分享 技术交流 会员登录
phpGrace GSCMS 公众号系统
运行 · 调试 · 异常

1. 运行流程

phpGrace 框架运行流程 : 
01. http 请求, 如 : http://www.phpgrace.com/index;
02. 服务器伪静态规则将请求统一重定向到入口页面( 某个具体站点或分组下的 index.php );
03. 框架核心文件初始化运行;
04. 路由解析 : 运行解析规则对应的控制器及方法,并解析保存其他 url 参数;
05. 调用缓存、模型、工具、视图等完成某个具有页面的运行工作;

2. 运行追踪

phpGrace 内置了调试功能,可以在运行页面展示一下调试信息 :
01. 真实 url 信息
02. 当前请求服务器运行时间、消耗内存数量;
03. 当前请求执行过程中引用的所有文件;
04. sql 运行日志,包含 : 数据库链接信息、sql 语句、查询耗时、错误信息等;
打开/关闭

框架默认开启追踪,一旦开发完毕,并将项目部署至服务器,就应该关闭此功能,关闭方法 :
打开对应站点或分组目录下的入口文件 : /index.php

define('PG_TRACE', false);

注意事项

调试会在请求页面直接展示调试所需的 html 结果,如果您开发的是应用 api 接口请关闭调试,避免调试内容影响接口请求数据。

3. 错误

phpGrace 重构了 php 的错误展示,以较为清晰的方式来展示代码错误;

打开/关闭错误展示

框架默认展示错误信息,一旦开发完毕,并将项目部署至服务器,就应该关闭错误展示,关闭方法 :
打开对应站点或分组下的入口文件 : /index.php

define('PG_DEBUG', false);

部署环境下查看错误

当您关闭错误展示后( 项目部署到生产环境 ),系统会将错误信息记录到 站点或分组目录下的 errorLog.txt,您可以通过此文件发现部署后的错误信息。

部署环境关闭错误记录

当您的站点运行良好,您可以关闭错误记录功能,避免因为大量错误记录影响项目的运行效率,
关闭记录方法 : 打开对应站点或分组下的入口文件 : /index.php

define('PG_REC_ERROR_LOG', false);

4. 异常

框架以错误展示功能为基础对封装了异常机制,展示或关闭规则与错误机制一致。

抛出异常

// 语法 : 
throw new graceException(
    错误信息,
    编码
);
// 例子 :
throw new graceException(
    PG_C." 控制器必须继承 grace\grace 基础控制器。",
    100000
);

说明

为了保证项目的完整性和正确性,不论是错误还是异常,都会终止程序继续运行

框架内置异常信息及错误编码

# 基础异常
100000 控制器必须继承 grace\grace 基础控制器
100001 控制器的方法缺少参数
100002 语言包文件不存在
100003 对象尚未在容器内注册
100004 全局配置文件不存在
100005 不存在的配置项
100006 不存在的 $_SERVER 数据
100007 数据验证规则配置错误
100008 session 存储类型设置错误

# 数据操作相关异常
100020 据库连接失败,请检查配置
100021 sql 命令条件设置缺少基础条件
100022 数据操作时插入数据为空
100023 操作数据时未指定数据表
100024 删除数据必须设置条件
100025 更新数据必须设置条件
100026 数据校验规则为空

# 模型异常
100050 模型数据校验不通过
100051 模型内添加数据失败
100052 模型内删除数据失败