程序文件详解（逐目录逐文件）

两套程序各有哪些文件、谁 require 谁、表是怎么配出来的、哪些文件不能公开。需要访问口令。

〇、先建立一张全局图

这一套东西里其实装着三类互相独立的程序，共用一份代码仓库，但各有各的入口、配置和数据表前缀：

• 四套程序：laolicms 是根目录 index.php + application/（库 laoli_new 这类）， 另外三套 llseo / laoli-toolbox / laoli-bizhi 各自一个目录一套库，装到客户站点上跑内容、工具、壁纸。
• 官网：web/ 根目录，纯静态加 inc/site.php，没有数据库；首页是 laolicms 的介绍， /seo/、/tool/、/bizhi/ 各是一个二级目录，文档在 /docs/{程序}/。
• 授权中心：web/shouquan/ 一个独立应用，自己的 index.php、config.php、自己的库（laoli_lic，表前缀 un_）， 卖四套程序、发授权码、发模板与插件包，对外提供 /api/ 校验、目录、更新与下载接口。

几边代码互不引用：官网与授权中心都不 require application/ 里的任何东西，程序也不碰 web/。 相同的函数名（guojiz()、arcurl()、siteurl()…）是各自 inc/fun.php 里的独立实现，改一边不会同步另一边。

一、加载顺序（读代码从这里入手最快）

CMS 端

1. index.php 只做一件事：require application/inc/common.php。
2. common.php 定义 IN_APP、UN_VERSION、UN_ROOT、APP_PATH， 没装（没有 application/config.php）就跳安装向导。
3. 依次 require db.php → page.php → tpl.php → fun.php → schema.php → jifen.php → license.php， 然后建全局连接 db()、开 UNSESSID 会话。
4. 继续 require form.php（表单令牌/防刷）、user.php（会员）、jump.php（跳转统计）、plugin.php（插件扫描）。
5. route() 按 url 第一段分发：内置频道走各自函数，剩下的按子系统标识走通用 page_index/page_list/page_detail； 论坛、收录申请、ajax 这些才按需再 require forum.php、apply.php、ajax.php、misc.php。
6. 后台每个页面第一行都是 require __DIR__.'/global.php'，鉴权、CSRF、控件渲染全在里面。

授权中心端

1. web/shouquan/index.php → web/shouquan/inc/common.php：定义路径、读 web/shouquan/config.php、连库、开 UNSESSID 会话。
2. common.php 里 route() 先跑内置频道（buy/order/license/dev/download/plan/user/forum/notice/search/tag/page）， 剩下的按子系统标识取货；定义在 UN_ADMIN / UN_API 时不跑前台路由。
3. web/shouquan/admin/*.php 各自 require global.php：超管门槛（admin_need_super()）、 admin_safe_post() 会话令牌、admin_input() 字段控件、admin_data() 表单收集都在这里。
4. 下单、签发、下载这条商业主线在 inc/order.php + inc/license.php + inc/shop.php， 对外四个接口在 web/shouquan/api/，鉴权与限流在 web/shouquan/inc/api.php。

官网端

1. 根目录 web/index.php 与四个程序落地页都是静态页，数据只在 web/inc/site.php 一处（程序名、版本、价格、功能清单、下载地址）。
2. 文档在 web/inc/docs.php + web/inc/docs/{程序}/*.html，片段里的 {site}、{store}、{doc:xxx} 在输出前替换成真实地址，所以同一份片段既能从官网根目录走，也能从二级目录走。

二、数据库结构要点

字段配置驱动是这一套程序的核心：子系统不是代码写死的，而是三张表配出来的。

• un_sys：一个子系统一行，记标识、别名 url、内容表名、每页条数、默认排序、开关分类、列表/详情模板名。
• un_fields：这个子系统有哪些列、控件类型、哪个是标题/封面/正文、进不进列表/表单/搜索。
• un_sort：全部分类共用一张表，按 sys 区分，parent_id=0 是一级。
• un_content_标识：真正存内容的表，un_sys + un_fields 决定它有哪些列， 后台「数据工具」建子系统或补字段时按这两张表现建表（sys_build()）。
• un_config：站点设置，前台用 guojiz('键') 读；带 tpl_ 前缀的键属于模板设置。

官网端另有 un_plan（授权等级）、un_order（订单）、un_license / un_license_domain（授权码与绑定域名）、 un_dev_*（开发者投稿）、un_key（接口密钥）。CMS 端另有 un_user、un_forum_*、un_apply、 un_plugin、un_ad、un_nav、un_link、un_page、un_notice、un_stats 等。

删子系统要谨慎：商店、订单、下载、文档页都按 cms / mb / cj / doc 这四个标识取货（CMS 端的站点频道 html 是首页站块与收录申请依赖的核心），这几个只能停用不能删，后台已经拦住了。

三、逐个文件的职责

「作用」这一列直接从每个文件头部注释里取，改文件说明时记得同步改注释，两边一致才对得上。

laolicms 根目录与安装向导

CMS 内核 application/inc

CMS 后台 application/admin

官网（静态站）web

授权中心内核 shouquan/inc

授权中心后台 shouquan/admin

授权中心接口与安装

程序自己会写的几个目录

• application/cache/：模板编译产物，源文件改动自动重编译，删了会重建。
• application/plugin/、plugins/：插件目录，后台「插件管理」在线安装时往这里落文件。
• uploads/image/、uploads/file/、uploads/store/：后台上传的图片、附件与商店包缓存，前台地址由 upurl() 拼。
• uploads/tool/：在线工具「本地文件」这一类工具的文件目录。后台编辑一条工具，打开方式选「本地文件」， 可以上传文件，也可以把工具代码整段贴进编辑框——两种写法最后都写成 uploads/tool/文件名， 内页由 tool_local() 执行（.php 走 include，.html/.htm 原样输出）。 只认 .php/.html/.htm 三种扩展名，文件名里带 ../ 会被削成纯文件名，代码永远出不了这个目录； 目录里放的是可直接访问的独立文件，所以工具代码要写成内页里的片段，不必再套 html 骨架。 这个目录必须可写，否则上传与贴代码保存不了。

四、哪些文件绝不能公开

• application/config.php、web/config.php：数据库账号密码、站点地址，只在本机。
• application/install.lock、web/install.lock：装完请把 install/ 目录整个删掉，留着会被反复访问。
• application/cache/、web/cache/：模板编译产物与数据缓存，不用备份，删了自动重建。
• 授权签名密钥（data/license.secret 与配置里的 license_secret）：只在签发端，绝不进交付包。
• 开发用的 tools/（含 tools/_dev/）与本地伪静态入口 router.php：打包脚本会排除，别手工塞回包里。
• 本篇文档的访问口令本身只存在配置表里，不写进任何文件；前台勾了「口令保护」的文档要靠它才显示正文。

五、改代码前的三条约定

1. 每个 php 文件顶部保留五行块注释（程序名、作者、本文件作用、文件路径），新加的文件也要写，作用一栏要和实际行为一致。
2. 函数命名小写下划线，模板可见的公共函数一律放 inc/fun.php（按小节注释分组，开发文档的函数索引就是照小节收的）； 只有跟着路由走的取值函数（title_of()、field_html()…）放在 inc/common.php，两处都会被收进函数索引；只在某个后台页用的函数放那个页里。
3. 前台模板只依赖 fun.php 与 common.php 里这些函数和标签，不要在模板里 new 类或直连数据库； 需要新数据就在后台加一个子系统或字段，模板用 {list 标识 …} 取。