你正在阅读的是 Epigenetic 后生 v1.0版本 的文档！感谢您选择使用我们的框架，让我们一起共同进步吧...
本指南将帮助您快速了解如何使用 Epigenetic 后生框架。
通过访问 Epigenetic 官网，点击下载按钮获取最新版本的框架压缩包（ZIP 文件）。
将下载的 ZIP 文件解压，并将解压后的文件夹部署到 Nginx 的网站目录中，例如：
/var/www/html/your-project-folder为了确保框架正常运行，请在 Nginx 配置文件中添加以下伪静态规则：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
完成配置后，重新加载 Nginx 服务以使更改生效：
sudo systemctl reload nginx
框架根目录
├─index.php 入口文件 [框架文件]
│
├─function 公共方法目录 [框架目录]
│ ├─xxxx xxxx公共方法目录 [自定义目录]
│ │ └─xxxx.php 示例xxxx公共方法文件 [自定义文件]
│ └─public 全局公共方法目录 [框架文件]
│ └─myserver.php 服务器信息获取函数 [框架文件]
│
├─cache 视图缓存目录 [框架目录]
├─view_functions 视图标签目录 [框架目录]
├─class 公共操作类目录 [框架目录]
│ ├─Template.php 视图显示类 [框架文件]
│ └─Sql.php 数据库操作类 [框架文件]
│
├─controller 公共控制器目录 [框架目录]
│ ├─routing.php 路由控制器 [框架文件]
│ ├─login.php 登陆中间件控制器 [框架文件]
│ └─function 公共方法管理控制器 [框架文件]
│
├─data 全局配置等杂项目录 [框架目录]
│ ├─logs 框架日志目录 [框架目录]
│ ├─session 框架session目录 [框架目录]
│ ├─404.php 全局404页面 [框架文件]
│ ├─login.php 登陆中间件配置文件 [框架文件]
│ ├─sql.php 数据库配置文件 [框架文件]
│ ├─key.php 用户密钥文件 [框架文件]
│ └─config.php 全局配置文件 [框架文件]
│
├─app 应用实际目录 [框架目录]
│ ├─xxxx xxxx应用目录 [自定义目录]
│ │ └─xxxx.php xxxx应用文件 [自定义文件]
│ └─developer 开发者应用目录 [框架目录]
│ └─index.php 开发者应用文件 [框架文件]
│
├─theme 视图页面目录 [框架目录]
│ ├─xxxx xxxx应用视图目录 [自定义目录]
│ │ └─xxxx.php xxxx应用对应的视图 [自定义文件]
│ └─developer 开发者应用视图目录 [框架目录]
│ └─index.php 开发者用于显示的页面 [框架文件]
后生目录结构演示这个配置文件是框架的核心配置文件，它包含了框架的基础配置项，开发者模式配置项，路由配置项等，非常重要！开发前请仔细阅读。
// data/config.php
return [
/* 基础配置项 */
'Default_app' => 'developer', // 默认顶级应用名称
'View_display' => true, // 是否开启视图模式 （true: 开启，false: 关闭）
'Global_404' => true, // 是否开启全局 404 视图
'Sql' => 'null', // 数据库模式：'sql' 表示单数据库，'sqls' 表示多数据库，null 表示不使用数据库，数据库配置文件data/sql.php
/*开发者相关配置*/
'Developer_mode' => true, // 开发者模式（true: 开启，false: 关闭,生产力环境请关闭该模式）
'Debug' => true, // 是否开启调试模式（true: 显示错误信息，false: 隐藏错误信息）
/* 路由相关配置项 */
'Routing_suffix' => 'easy', // 路由后缀，默认为空，可以设置为 'html'
'Routing_login' => true, // 是否登陆中间件 （true: 开启，false: 关闭）,登陆中间件配置文件 data/login.php
/* 视图相关配置项 */
'Show_cache' => false, // 是否缓存视图 （true: 开启，false: 关闭,会在cache目录生成缓存视图文件，可以有效提高视图的效率）
'View_channels' => false, // 是否开启视图互通模式（true: 允许，false: 不允许）
'View_security' => 'null', // 视图文件安全检查模式 （null: 不限制，forbid: 禁止模式[仅禁止使用指定的函数]，allow：允许模式[仅允许使用指定的函数]）
'View_safe_array' => ['include', 'if',],
// 允许的函数列表,用户可用自行决定增删
];
配置项文件代码
'Default_app' => 'developer', // 默认顶级应用名称
'View_display' => true, // 是否开启视图模式 （true: 开启，false: 关闭）
'Global_404' => true, // 是否开启全局 404 视图
'Sql' => 'null', // 数据库模式：'sql' 表示单数据库，'sqls' 表示多数据库，null 表示不使用数据库，数据库配置文件data/sql.php
基础配置项
'Developer_mode' => true, // 开发者模式（true: 开启，false: 关闭,生产力环境请关闭该模式）
'Debug' => true, // 是否开启调试模式（true: 显示错误信息，false: 隐藏错误信息）
开发者相关配置
'Routing_suffix' => 'easy', // 路由后缀，默认为空，可以设置为 'html'
'Routing_login' => true, // 是否登陆中间件 （true: 开启，false: 关闭）,登陆中间件配置文件 data/login.php
路由相关配置项
'Show_cache' => false, // 是否缓存视图 （true: 开启，false: 关闭,会在cache目录生成缓存视图文件，可以有效提高视图的效率）
'View_channels' => false, // 是否开启视图互通模式（true: 允许，false: 不允许）
'View_security' => 'null', // 视图文件安全检查模式 （null: 不限制，forbid: 禁止模式[仅禁止使用指定的函数]，allow：允许模式[仅允许使用指定的函数]）
'View_safe_array' => ['include', 'if',],
视图相关配置项 这篇文档将详细介绍EasyPHP的应用目录结构及应用编写规则。
应用目录结构
├─app 应用实际目录 [框架目录]
│ ├─xxxx xxxx应用目录 [自定义目录]
│ │ └─xxxx.php xxxx应用文件 [自定义文件]
│ └─developer 开发者应用目录 [框架目录]
│ └─index.php 开发者应用文件 [框架文件]
应用目录结构演示这篇文档将详细介绍EasyPHP的公共方法的目录和编写。
公共方法目录结构
├─function 公共方法目录 [框架目录]
│ ├─xxxx xxxx公共方法目录 [自定义目录]
│ │ └─xxxx.php 示例xxxx公共方法文件 [自定义文件]
│ └─public 全局公共方法目录 [框架文件]
│ └─myserver.php 服务器信息获取函数 [框架文件]
公共方法目录结构演示
// 你可以参考下面的编写格式。
function U($url) {
echo WEB_URL.APP_NAME.$url;
}
这样编写后你就可以在应用中直接调用U()函数了
PHP代码演示这篇文档将详细介绍EasyPHP的视图目录和编写。
视图目录结构
├─theme 视图页面目录 [框架目录]
│ ├─xxxx xxxx应用视图目录 [自定义目录]
│ │ └─xxxx.php xxxx应用对应的视图 [自定义文件]
│ └─developer 开发者应用视图目录 [框架目录]
│ └─index.php 开发者用于显示的页面 [框架文件]
视图目录结构演示
// 当你在app/admin/index.php编写逻辑后，你需要为admin/index指定视图时你可以使用以下代码。
$mine->Template->show('index.php');
该方法只需要一个参数，即视图文件路径。
上述代码指定的视图文件为admin/index.php，当访问http://你的域名.com/admin/index时，你看到的为theme/admin/index.php。
PHP代码演示
// 当你在app/admin/index.php编写逻辑过程中你需要向视图传参，你可以使用以下代码。
$mine->template->give('userid', $_SESSION['user_id']);
该方法接收两个参数，第一个参数为键名，第二个参数为键值。
上述代码传递了一个名为userid的参数，值为$_SESSION['user_id']。
PHP代码演示
// 当你在完成向视图传参后你可以在视图文件调用传递的参数。
echo $userid;
传递的参数以变量的形式进行调用。
PHP代码演示这篇文档将详细介绍的视图标签和编写,在编写您的自定义标签前建议先阅读现有标签的编写，本文件仅介绍框架标签和标签的编写，扩展标签请查看对应的标签文档。
// 当你在编写逻辑时遇到需要被保护的静态文件，你可以使用NO标签防止静态文件被解析
例如：有些Js代码可能会被当作模板标签解析替换掉，造成Js异常，这时候我们可以使用no标签包含下，Js就正常了。
{no}不解析的代码片段{/no}
PHP代码演示
// 当你在前端调用系统常量时，你可以使用以下代码{常量}，这样的写法可以直接输出常量，从而减少开发时间，常量需要为全大写。
{WEB_URL}
会被解析为 echo WEB_URL;
PHP代码演示
// 当你在前端调用变量时，你可以使用以下代码{变量}，这样的写法可以直接输出变量，从而减少开发时间。
变量输出标签支持各种类型的变量，例如$name,$data.id,$data['id']等。
{userid}
会被解析为echo $userid;
PHP代码演示
// 当你在前端需调用公共函数是时，你可以使用以下代码{函数名}，这样的写法可以直接调用公共函数，从而减少开发时间。
公共函数需首字母大小
{U('index')}
会被解析为调用公共函数U传递参数index
PHP代码演示
// 你可以参考这个演示的代码格式，编写标签。
return function ($params) {
// 提取参数
$condition = $params['condition'] ?? '';
$content = $params['content'] ?? '';
// 匹配 foreach 条件部分
if (!preg_match('/\$(\w+)\s+as\s+\$(\w+)(?:\s*=>\s*\$(\w+))?/', $condition, $matches)) {
throw new Exception("无效的 foreach 标签条件:
Notice: Undefined variable: condition in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 984
");
}
$arrayName = $matches[1]; // 数组变量名
$valueVar = isset($matches[3]) ? $matches[3] : $matches[2]; // 值变量名
$keyVar = isset($matches[3]) ? $matches[2] : null; // 键变量名（可选）
// 验证变量名是否合法
if (!preg_match('/^\w+$/', $arrayName) || !preg_match('/^\w+$/', $valueVar) || ($keyVar && !preg_match('/^\w+$/', $keyVar))) {
throw new Exception("无效的变量名:
Notice: Undefined variable: condition in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 993
");
}
// 构建 PHP foreach 代码
$phpCode = "< ?php if (is_array(\$
Notice: Undefined variable: arrayName in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 997
) || \$
Notice: Undefined variable: arrayName in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 997
instanceof Traversable): ?>";
if ($keyVar) {
// 如果有键变量，则生成带键的 foreach
$phpCode .= "< ?php foreach (\$
Notice: Undefined variable: arrayName in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 1000
as \$
Notice: Undefined variable: keyVar in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 1000
=> \$
Notice: Undefined variable: valueVar in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 1000
): ?>";
} else {
// 如果没有键变量，则只生成值的 foreach
$phpCode .= "< ?php foreach (\$
Notice: Undefined variable: arrayName in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 1003
as \$
Notice: Undefined variable: valueVar in /www/wwwroot/epigenetic.myapi.work/cache/user/docs.php.php on line 1003
): ?>";
}
$phpCode .= $content;
$phpCode .= "< ?php endforeach; endif; ?>";
return $phpCode;
};
PHP代码演示以下是框架的公共类的相关介绍。
公共类目录结构
├─class 公共操作类目录 [框架目录]
│ ├─Template.php 视图显示类 [框架文件]
│ └─Sql.php 数据库操作类 [框架文件]
公共类目录结构演示
// 示例 PHP 代码
$mine ->类名->方法名();
PHP示例代码
//你可以参考下面的这种写法
class Returns
{
/**
* 返回错误信息
*
* @param string $message 错误信息
* @return void 输出 JSON 格式字符串
*/
public function error($message)
{
echo json_encode([
'state' => 'error',
'msg' => $message
], JSON_UNESCAPED_UNICODE);
}
/**
* 返回成功信息
*
* @param string $message 成功信息
* @return void 输出 JSON 格式字符串
*/
public function success($message)
{
echo json_encode([
'state' => 'success',
'msg' => $message
], JSON_UNESCAPED_UNICODE);
}
}
PHP示例代码