🔧 二次开发与功能扩展
PbootCMS 的真正强大之处在于其可扩展性。
核心开发步骤
PbootCMS 的二次开发主要涉及三个层面：模板修改、添加控制器和扩展数据库。
开发层面
描述
常用操作/技术
模型与栏目关系
模型定义数据结构，栏目是内容的分类容器并需绑定一个模型
后台创建模型并管理字段，栏目绑定模型以实现不同内容结构
模板（视图层）
使用 Smarty 模板引擎，修改 /template/ 目录下的文件
使用 PbootCMS 标签输出数据，修改 HTML 结构，添加自定义区块
控制器
处理业务逻辑，添加新功能或 API 接口
在 /app/controller/ 下创建新控制器，定义方法，配置路由
模型与数据库
扩展数据表或字段，使用迁移文件管理数据库变更
创建数据库迁移文件，使用 php think migrate:run 执行更新
创建自定义控制器
通过创建新的控制器，你可以为网站添加全新的功能，例如一个简单的新闻 API 接口：
代码语言：javascript
AI代码解释
<?php
namespace appcontroller;
use thinkController;
use appmodelContent; // 引入内容模型
class CustomController extends Controller
{
// 定义一个获取新闻列表的API
public function getNews()
{
$news = Content::where('scode', 1)->order('date', 'desc')->limit(5)->select();
return json(['code' => 200, 'data' => $news]);
}
}
?>
扩展数据库
使用迁移文件来为系统添加新的数据表，这样可以安全地管理数据库结构的变化：
代码语言：javascript
AI代码解释
<?php
use thinkmigrationMigrator;
class AddCustomTable extends Migrator
{
public function change()
{
$table = $this->table('custom_data'); // 创建新表 custom_data
$table->addColumn('name', 'string', ['limit' => 50]) // 添加 name 字段
->addColumn('value', 'text') // 添加 value 字段
->create(); // 执行创建
}
}
?>
执行迁移命令后，新的 custom_data 表就会被创建到数据库中：
代码语言：javascript
AI代码解释
php think migrate:run
🎨 模板制作与切换
模板决定了网站的外观和用户体验。
模板基础知识
PbootCMS 使用 Smarty 模板引擎。所有的模板文件都存放在 /template/ 目录下。一个完整的模板通常包含以下几个核心文件：
index.html: 首页模板
list.html: 列表页模板
content.html: 内容页模板
config.php: 模板配置文件
模板调用与切换
上传新模板：将下载或制作的新模板文件夹（例如 new_theme）上传到服务器的 /template/ 目录下。
后台切换：登录 PbootCMS 后台，进入“全局配置” -> “模板风格”，在“模板风格名称”中输入新模板的文件夹名（如 new_theme），保存并刷新缓存即可生效。
资源路径：在模板中引用 CSS、JS 或图片等静态资源时，务必使用 {pboot:sitetplpath} 标签来动态获取模板路径，以防止路径错误：
<!-- 正确示例 --> <link rel="stylesheet" href="{pboot:sitetplpath}/css/style.css">
<!-- 错误示例 --> <link rel="stylesheet"="/template/new_theme/css/style.css">
<!-- 硬编码路径，更换模板名后可能失效 -->
多模板共存与高级调用
你可以通过条件判断，为不同的栏目或页面加载不同的模板：
代码语言：javascript
AI代码解释
{pboot:if('{sort:scode}'=='1')} <!-- 假设栏目ID为1使用新模板 -->
{include file='new_theme/index.html'}
{else}
{include file='default/index.html'}
{/pboot:if}
🔨 调试与性能优化
高效的调试和优化能提升开发效率和网站体验。
调试技巧
开启调试模式：在开发阶段，修改 /config/app.php 文件，将 'app_debug' => true，这样可以在出现错误时看到更详细的错误信息，方便定位问题。
查看日志：系统运行的日志文件存放在 /runtime/log/ 目录下，遇到疑难杂症时可以查看日志获取线索。
清理缓存：修改模板或配置后，如果前台没有立即生效，记得进入后台“清除应用缓存”。缓存文件存放在 /runtime/ 目录下，手动删除该目录下的文件同样可以达到清理缓存的效果。
性能优化建议
启用缓存：充分利用 PbootCMS 内置的缓存功能，如文件缓存，或考虑集成 Redis、Memcached 等更高效的内存缓存。
优化前端资源：合并和压缩 CSS、JavaScript 文件，减少 HTTP 请求数量。
数据库优化：对常用的查询字段建立数据库索引，并在模型层适当使用缓存来减少数据库查询压力。
安全加固
防止 XSS 攻击：在模板中输出用户提交或不确定的内容时，使用 escape 过滤器进行转义：{$your_variable|escape}。
过滤用户输入：在控制器中处理用户输入（如表单提交）时，使用 input() 函数进行过滤，以防止 SQL 注入等安全问题。
修改后台路径：考虑将默认的后台登录路径 /admin/ 修改为其他不易被猜到的路径，增加安全性。
🌐 多语言支持（判断与高亮）
如果你的网站需要支持多种语言，PbootCMS 也提供了相应的机制。
判断当前语言并高亮
可以根据当前站点的语言设置，为对应的语言切换按钮添加高亮样式：
代码语言：javascript
AI代码解释
<a href="{pboot:siteurl}" class="btn {pboot:if('{pboot:sitelanguage}'=='cn')}active{/pboot:if}">首页</a>
{pboot:siteurl}：获取网站的根路径。
{pboot:sitelanguage}：获取当前站点的语言设置（如 'cn' 表示中文）。 当网站语言为中文时，'{pboot:sitelanguage}'=='cn' 条件成立，就会为按钮添加 active 类，从而实现高亮效果。
⚙️ 其他实用技巧
Ajax 无刷新加载：PbootCMS 的 API 接口使得实现 Ajax 加载内容变得相对方便。例如，你可以实现 Ajax 无刷新加载列表内容。但需要注意，过度使用 Ajax 加载方式可能对 SEO（搜索引擎优化）不太友好。
在模板中执行 PHP 代码：PbootCMS 模板中支持直接编写 PHP 代码，有两种方式： <!-- 方法一：使用 pboot 标签 --> {php} echo 'Hello World!'; {/php} <!-- 方法二：使用原生 PHP 标签 --> <?php echo 'Hello China!'; ?>
重要提示：由于 PbootCMS 的模板解析机制，直接在 {php} 标签或 <?php ?> 中处理 PbootCMS 的标签变量（如 {content:title}）通常是无效的，这些标签在被 PHP 执行时已经被解析或替换了。