YaoGuang PHP Frame -> 摇光PHP框架

早期摇光框架地址: 摇光PHP框架

什么是摇光PHP框架？

摇光框架是一个基于MVC的轻量、高效、灵活、安全的PHP框架，借助此框架，可以快速构建后端站点，且便于维护，可方便扩展.

此框架开发于2023年1月30日 前身是一个名为玄元框架的不规则shit山聚合体...

目录结构

(-D) Root +
{
    (-D) config + 配置目录
    {
        main_config.php 框架主配置文件
    }
    (-D) inc + 主程序引用目录
    {
        (-D) core + 框架核心目录
        {
            (-F) function.php 框架核心函数文件
            (-F) initial.php 框架初始化文件
            (-F) start.php 框架启动文件
        }
        (-D) function + 框架扩展及函数库目录
        {
            (-F) func_login.php 用户管理扩展文件
            (-F) func_mail.php 站内邮件扩展文件
            (-F) func_tool.php 函数库扩展文件
        }
        (-D) language - 框架模板引擎占位符配置目录
        {...}
        (-D) namespace + 框架命名空间目录
        {
            (-F) YaoGuang.php 框架核心功能文件
        }
        (-F) common.inc.php 通用接引文件 在框架目录下任何需要接入框架的程序文件都需要引用此文件方可正常调用框架
        (-F) phptpl.inc.php 模板引擎文件
        (-F) title.inc.php 各页面标题定义文件
    }
    (-D) static - 框架默认提示信息模板目录
    {...}
    (-D) cache 缓存目录 此目录将在使用YaoGuang\cache类后自动生成
    (-D) data 数据目录 此目录将在使用YaoGuang\UploadData类后自动生成
    (-D) log 日志目录 此目录将在使用YaoGuang\LogHandler类后自动生成
    (-D) template 模板目录 此目录的文件将通过模板引擎处理后发往前端
    (-F) 404.php HTTP404 错误页
    (-F) 502.php HTTP502 错误页
    (-F) api.php 接口文件 通常用于前后端通信，使用ajax前需在主配置文件中允许跨域请求
    (-F) index.php 主入口文件 定义页面入口
}

在使用之前

请确保服务器已安装以下PHP扩展:

• pdo_mysql
• curl

建议使用的伪静态 _ nginx

您也可以根据自己的需要对伪静态进行修改

location / 
{
    rewrite (.*).html /index.php?mods=$1 last;
}

建议使用的伪静态 _ apache

RewriteEngine On
RewriteRule ^(.*)\.html$ /index.php?mods=$1 [L]

配置文件

请根据你的站点信息配置config目录下的main_config.php文件

示例

以下是框架主入口文件index.php基础示例

<?php
    /**
     * 摇光PHP框架
     * 文件类型: 主入口文件
     * 开发日期: 2023 01 30
     */
    
    define("PAGE_TYPE" , "INLET");
    include("./inc/common.inc.php");

    if(!isset($_GET["mods"]) || is_null($_GET["mods"])){
        $_GET["mods"] = "index";
    }
    $mods = $_GET["mods"];

    YaoGuang\PageOperation::jump_home();

    switch($mods){
        case 'index':
            //主页
            //include...
            tpl::phptpl_file( "./template/" . $_CONFIG["main"]["template"] . "/index.html" , $str_replace_array , null , null , $if_exist_array , null , true );

            break;
        default:
            $file = "./template/".$_CONFIG["main"]["template"] . "/" . $mods . ".html";
            if(file_exists($file)){
                //模板
                tpl::phptpl_file( $file , $str_replace_array , null , null , null , null , true );
            }else{
                http_response_code(404);
            }
    }

这段代码意为:

• 在从框架根目录访问index.html或index.php时，都将自动转至 https://www.youdoname.com/上，即自动去除文件名，然后将模板目录下的模板文件index.html发送给用户
• 检查用户在地址栏输入的文件名，比如https://www.youdoname.com/testpage.html这个URL，框架就会从模板文件夹寻找名为testpage.html的文件，并通过框架带有的模板引擎处理后发送给用户，如果此文件不存在，将返回一个HTTP 404的状态码

如果您想要在此文件定义什么文件名将发送什么内容给用户，可以添加一个case分支在switch($mod)下，例如:

switch($mods){
        case 'index':
            //主页
            //include...
            tpl::phptpl_file( "./template/" . $_CONFIG["main"]["template"] . "/index.html" , $str_replace_array , null , null , $if_exist_array , null , true );

            break;
        case 'yourpage.html':
            //自定义页面内容
            fileflow_download("./yourfile.dat");

            break;
        default:
            $file = "./template/".$_CONFIG["main"]["template"] . "/" . $mods . ".html";
            if(file_exists($file)){
                //模板
                tpl::phptpl_file( $file , $str_replace_array , null , null , null , null , true );
            }else{
                http_response_code(404);
            }
    }

关于这段代码:

• 这段代码将使用户在访问https://www.youdoname.com/yourpage.html时，服务器将同目录的./yourflie.dat文件发送给用户的浏览器 (用户浏览器会弹出下载提示)
• fileflow_download()函数是inc/function目录下的扩展文件func_tool.php函数库的一部分，此函数用于以文件流形式将文件发送给用户浏览器

除此之外，您可以通过将fileflow_download("./yourfile.dat");替换为:

tpl::phptpl_file( "./template/" . $_CONFIG["main"]["template"] . "/header.html" , $str_replace_array , null , null , $if_exist_array , null , true );
tpl::phptpl_file( "./template/" . $_CONFIG["main"]["template"] . "/body.html" , $str_replace_array , null , null , $if_exist_array , null , true );
tpl::phptpl_file( "./template/" . $_CONFIG["main"]["template"] . "/footer.html" , $str_replace_array , null , null , $if_exist_array , null , true );

若入口文件聚合的多个页面同时引用了header.html或footer.html，您就可以修改这两个文件而不用每个页面文件都修改一次了