TP5自定义函数不能直接裁剪字符串或图像，需自行实现逻辑：字符串裁剪须用mb_substr()支持中文，图片裁剪应封装第三方库并在控制器调用，模板仅适合纯数据处理。
TP5 自定义函数不能直接“裁剪”字符串或图像——它只是 PHP 函数的封装入口，裁剪逻辑必须你自己写清楚，否则模板里调用 {$str|mySubstr} 会报错或输出空。
自定义字符串裁剪函数（支持中文）
TP5 模板中用 {$str|mySubstr=10,2} 这类语法，本质是调用你写的 PHP 函数并传参。但 PHP 原生 substr() 对中文会乱码，必须用 mb_substr() 替代，且需确保 mbstring 扩展已启用。
- 在
application/common.php中添加：
function mySubstr($str, $start = 0, $length = 10, $suffix = '...') {
if (!is_string($str) || mb_strlen($str, 'UTF-8') <= $length) {
return $str;
}
$cut = mb_substr($str, $start, $length, 'UTF-8');
return $cut . $suffix;
}
- 模板中使用：
{$title|mySubstr=15,'...'}（注意：参数顺序必须和函数定义一致） - 常见错误：
mb_substr()第四个参数漏写编码，或函数名拼错导致模板直接输出原始字符串 - 性能提示：频繁调用时避免在函数内重复判断
mb_strlen，可提前缓存长度
自定义图片裁剪函数（不依赖 GD/Imagick）
TP5 本身不提供图片裁剪能力，所谓“自定义裁剪函数”其实是封装第三方库（如 intervention/image）或原生 GD 函数。直接在 common.php 里写 GD 代码极易出错，更推荐封装成服务类。
- 先用 Composer 安装：
composer require intervention/image - 在
application/common.php中只做轻量封装：
function cropImage($path, $width, $height, $x = 0, $y = 0) {
if (!file_exists($path)) return '';
try {
$img = \Intervention\Image\Facades\Image::make($path);
$img->crop($width, $height, $x, $y);
$newPath = dirname($path) . '/crop_' . basename($path);
$img->save($newPath);
return $newPath;
} catch (\Exception $e) {
return '';
}
}
- 控制器中调用：
$cropPath = cropImage('public/uploads/a.jpg', 200, 150); - 关键限制：该函数不能在模板中直接用
|调用，因为涉及文件 I/O 和异常，模板层只适合纯数据处理 - 容易踩的坑：
public/uploads/目录不可写、GD 扩展未启用、intervention/image版本与 PHP 8.x 不兼容（建议用 v2.7+）
模板中裁剪调用失败的典型表现
你以为写了函数就能在模板里用，但实际常卡在这几个点：
- 函数没返回值（忘记
return），模板显示空白或原字符串 - 参数个数不匹配：
{$str|mySubstr=5}传了 1 个参数，但函数定义是mySubstr($str, $len, $suffix)，会静默忽略多余参数 - 路径问题：函数放在
common.php，但项目启用了多应用模式，common.php实际没被加载（检查app/middleware.php或入口文件是否引入） - 字符编码错误：函数里用了
substr()处理中文标题，结果前几个字变成
真正要“裁剪”，得先分清对象：字符串裁剪是纯计算，可放模板；图片裁剪是 IO 操作，必须放控制器或服务层。别指望一个函数通吃所有场景。
