节点表单：时间框整块可点、起点终点一键导航、可直接传多张附件
三件事都是「界面上明明该有、但用起来不通」的地方：
1) 时间输入框只能点右侧那个小日历图标才弹选择器
原生行为如此（而且各浏览器还不一致），用户会以为输入框是只读的。
在全局脚本里给 datetime-local / date 挂 click → showPicker()，
等于把整块输入区都当成那个图标；选择器已在显示时再调是空操作，
不支持的浏览器静默跳过。顺带给可点光标。
写在 layout.php 里，所以签到时间等其它时间框一并生效。
2) 起点/终点的精确位置此前只存在页面上，没有落库
高德选点回调里拿到的 lng/lat 现在随节点一起存库，节点详情页和
表单页都生成高德导航链接，点一下就能直接导航过去（手机端会尝试
唤起高德 App）。链接只给 to 不给 from，让移动端自动用当前位置当起点。
⚠️ 高德 URI API 的坐标顺序是「经度,纬度」，写反了不报错、只会安静地
导到地球另一边，所以单独写了单元测试守住顺序。
手工改地名时会清掉旧坐标，退化成关键字搜索，避免「名字改了位置没改」。
3) 节点处不能上传图片附件
节点表单改成 multipart，加拖放区 + 多选 + 本地预览 + 逐个移除，
编辑态可勾选删除已有附件（逐条校验归属，防止改 id 删到别人家的文件）。
上传逻辑从 AttachmentController 抽到 src/Uploads.php，两处共用一份：
MIME 白名单、大小上限、孤儿回滚各抄一份迟早走偏。
请求体超过 post_max_size 时 PHP 会静默丢掉 $_POST 与 $_FILES，紧随的
CSRF 校验必然失败、报「请求已过期」——这是最难排查的一类问题。
现在按 CONTENT_LENGTH 提前识别并给出人话提示，且该守卫必须排在
csrf_check() 之前（只读长度、不改状态，所以顺序上是安全的）。
已验证：本地 php -l 全量、模板渲染 255 项、amap_nav_url 单测 18 项、
真实浏览器交互 47 项（时间框三处点击都弹、多选/移除后 input.files 真被
改写、超限被前端拦下、导航链接随选点刷新、勾选删除变红、三视口无溢出）、
打包 57 文件、远端 e2e 267 项，全部通过；部署后双 PHP 渲染逐字节一致。
This commit is contained in:
+262
@@ -0,0 +1,262 @@
|
||||
<?php
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace App;
|
||||
|
||||
/**
|
||||
* 把「一个请求里带上来的文件」写成附件。
|
||||
*
|
||||
* 抽成独立类是因为有两个入口都要用它：
|
||||
* · AttachmentController::upload —— 节点照片页的独立上传
|
||||
* · NodeController::store/update —— 节点表单里跟节点一起提交的附件
|
||||
* 两边各写一份的话，MIME 白名单、大小上限、孤儿文件回滚这些迟早会走偏。
|
||||
*
|
||||
* 两类入参（沿用原设计，别再合并）：
|
||||
* files[] —— 普通 multipart 文件（原图、PDF……）省流量，不预压
|
||||
* cropped[] —— 前端裁过/压过的图片，JSON 字符串 [{"name":..,"data":"data:image/..;base64,.."}]
|
||||
*/
|
||||
final class Uploads
|
||||
{
|
||||
/** 单次请求最多处理的文件数，防止一次拖几百个把请求拖死 */
|
||||
public const MAX_FILES = 30;
|
||||
|
||||
/** 单文件硬上限 */
|
||||
public const MAX_BYTES = 20971520; // 20MB
|
||||
|
||||
/**
|
||||
* 把 php.ini 里的 "8M" / "50M" 这类写法换算成字节数。
|
||||
*
|
||||
* 直接转发给全局的 ini_bytes()（helpers.php 里那个，模板也在用）——
|
||||
* 项目里只能有一份实现，否则两处迟早对 '-1'（不限）这类边界值理解不一致。
|
||||
*/
|
||||
public static function iniBytes(string $value): int
|
||||
{
|
||||
return \ini_bytes($value);
|
||||
}
|
||||
|
||||
/**
|
||||
* 「整个请求体超过 post_max_size」时，PHP 会**静默丢掉 $_POST 和 $_FILES**，
|
||||
* 表现为「点了保存但什么都没发生 / CSRF 校验失败」——最难排查的一类问题。
|
||||
* 这里按 CONTENT_LENGTH 提前认出来，好给用户一句能懂的话。
|
||||
*/
|
||||
public static function requestTooLarge(): bool
|
||||
{
|
||||
$len = (int)($_SERVER['CONTENT_LENGTH'] ?? 0);
|
||||
if ($len <= 0) {
|
||||
return false;
|
||||
}
|
||||
$max = self::iniBytes((string)ini_get('post_max_size'));
|
||||
return $max > 0 && $len > $max;
|
||||
}
|
||||
|
||||
/** 站点设置的「单张照片上限」（字节） */
|
||||
public static function maxPhotoBytes(): int
|
||||
{
|
||||
return (int)Settings::get('photo_max_mb', '12') * 1024 * 1024;
|
||||
}
|
||||
|
||||
/**
|
||||
* 处理 $_FILES 里的某个多选字段（形状来自 name="xxx[]"）。
|
||||
*
|
||||
* @param int $countStart 已经计入上限的文件数（files 与 cropped 共用同一个上限）
|
||||
* @return array{uploaded:int, errors:string[], count:int}
|
||||
*/
|
||||
public static function handleFiles(
|
||||
array $filesField,
|
||||
string $targetType,
|
||||
int $targetId,
|
||||
int $uploaderId,
|
||||
int $countStart = 0
|
||||
): array {
|
||||
$uploaded = 0;
|
||||
$errors = [];
|
||||
$count = $countStart;
|
||||
|
||||
if (empty($filesField) || !is_array($filesField['name'] ?? null)) {
|
||||
return ['uploaded' => 0, 'errors' => [], 'count' => $count];
|
||||
}
|
||||
|
||||
$photoMax = self::maxPhotoBytes();
|
||||
|
||||
foreach (self::restructure($filesField) as $file) {
|
||||
if ($count >= self::MAX_FILES) {
|
||||
$errors[] = '一次最多上传 ' . self::MAX_FILES . ' 个文件，多余的已忽略';
|
||||
break;
|
||||
}
|
||||
$count++;
|
||||
|
||||
if ($file['error'] !== UPLOAD_ERR_OK) {
|
||||
$errors[] = $file['name'] . '：上传错误（码 ' . $file['error'] . '）';
|
||||
continue;
|
||||
}
|
||||
$limit = $photoMax > 0 ? max($photoMax, self::MAX_BYTES) : self::MAX_BYTES;
|
||||
if ($file['size'] > $limit) {
|
||||
$errors[] = $file['name'] . '：超过大小上限';
|
||||
continue;
|
||||
}
|
||||
|
||||
$info = Mime::detectFile($file['tmp_name'], $file['name']);
|
||||
$mime = $info['mime'];
|
||||
if ($mime === null || !isset(Mime::ALLOWED[$mime])) {
|
||||
$errors[] = $file['name'] . '：不支持的文件类型';
|
||||
continue;
|
||||
}
|
||||
if ($info['is_image'] && $photoMax > 0 && $file['size'] > $photoMax) {
|
||||
$errors[] = $file['name'] . '：照片超过 ' . (int)Settings::get('photo_max_mb') . 'MB';
|
||||
continue;
|
||||
}
|
||||
|
||||
$raw = @file_get_contents($file['tmp_name']);
|
||||
if ($raw === false) {
|
||||
$errors[] = $file['name'] . '：读取临时文件失败';
|
||||
continue;
|
||||
}
|
||||
|
||||
$err = self::storeOne($targetType, $targetId, $uploaderId, $raw, $mime, $file['name'], $info);
|
||||
if ($err === null) {
|
||||
$uploaded++;
|
||||
} else {
|
||||
$errors[] = $file['name'] . '：' . $err;
|
||||
}
|
||||
}
|
||||
|
||||
return ['uploaded' => $uploaded, 'errors' => $errors, 'count' => $count];
|
||||
}
|
||||
|
||||
/**
|
||||
* 处理前端裁剪/压缩后的图片（base64 data URL）。
|
||||
*
|
||||
* @return array{uploaded:int, errors:string[], count:int}
|
||||
*/
|
||||
public static function handleCropped(
|
||||
string $json,
|
||||
string $targetType,
|
||||
int $targetId,
|
||||
int $uploaderId,
|
||||
int $countStart = 0
|
||||
): array {
|
||||
$uploaded = 0;
|
||||
$errors = [];
|
||||
$count = $countStart;
|
||||
|
||||
if (trim($json) === '') {
|
||||
return ['uploaded' => 0, 'errors' => [], 'count' => $count];
|
||||
}
|
||||
|
||||
$items = json_decode($json, true);
|
||||
if (!is_array($items)) {
|
||||
return ['uploaded' => 0, 'errors' => ['裁剪数据解析失败'], 'count' => $count];
|
||||
}
|
||||
|
||||
foreach ($items as $item) {
|
||||
if ($count >= self::MAX_FILES) {
|
||||
$errors[] = '一次最多上传 ' . self::MAX_FILES . ' 个文件，多余的已忽略';
|
||||
break;
|
||||
}
|
||||
$count++;
|
||||
|
||||
$name = (string)($item['name'] ?? 'photo.png');
|
||||
$data = (string)($item['data'] ?? '');
|
||||
if (!preg_match('#^data:(image/[a-z0-9.+-]+);base64,(.+)$#is', $data, $m)) {
|
||||
$errors[] = $name . '：裁剪结果格式不正确';
|
||||
continue;
|
||||
}
|
||||
$raw = base64_decode($m[2], true);
|
||||
if ($raw === false || $raw === '') {
|
||||
$errors[] = $name . '：图片解码失败';
|
||||
continue;
|
||||
}
|
||||
if (strlen($raw) > self::MAX_BYTES) {
|
||||
$errors[] = $name . '：超过 20MB';
|
||||
continue;
|
||||
}
|
||||
|
||||
$info = Mime::detectBuffer($raw);
|
||||
$mime = $info['mime'];
|
||||
if ($mime === null || !Mime::isImageMime($mime) || !isset(Mime::ALLOWED[$mime])) {
|
||||
$errors[] = $name . '：裁剪结果不是受支持的图片';
|
||||
continue;
|
||||
}
|
||||
|
||||
$err = self::storeOne($targetType, $targetId, $uploaderId, $raw, $mime,
|
||||
self::imageName($name, $mime), $info);
|
||||
if ($err === null) {
|
||||
$uploaded++;
|
||||
} else {
|
||||
$errors[] = $name . '：' . $err;
|
||||
}
|
||||
}
|
||||
|
||||
return ['uploaded' => $uploaded, 'errors' => $errors, 'count' => $count];
|
||||
}
|
||||
|
||||
/** 真正落库 + 落存储；成功返回 null，失败返回错误文案 */
|
||||
public static function storeOne(
|
||||
string $targetType,
|
||||
int $targetId,
|
||||
int $uploaderId,
|
||||
string $raw,
|
||||
string $mime,
|
||||
string $fileName,
|
||||
array $info
|
||||
): ?string {
|
||||
$ext = Mime::extFor($mime);
|
||||
if ($ext === null) {
|
||||
return '无法确定扩展名';
|
||||
}
|
||||
|
||||
try {
|
||||
$key = Storage::keyFor($ext, 'attachments');
|
||||
$stored = Storage::put($key, $raw, $mime);
|
||||
} catch (\Throwable $e) {
|
||||
return $e->getMessage();
|
||||
}
|
||||
|
||||
try {
|
||||
Attachments::create(
|
||||
$targetType,
|
||||
$targetId,
|
||||
$uploaderId,
|
||||
$stored,
|
||||
$fileName,
|
||||
$mime,
|
||||
(bool)$info['is_image'],
|
||||
$info['width'],
|
||||
$info['height']
|
||||
);
|
||||
} catch (\Throwable $e) {
|
||||
// 入库失败就把刚写的对象删掉，别留孤儿文件
|
||||
Storage::delete($stored['storage'], $stored['key']);
|
||||
return '入库失败：' . $e->getMessage();
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/** 裁剪结果统一成 .jpg/.png 这类名字，避免扩展名与真实格式不符 */
|
||||
public static function imageName(string $name, string $mime): string
|
||||
{
|
||||
$base = pathinfo($name, PATHINFO_FILENAME) ?: 'photo';
|
||||
return $base . '.' . (Mime::extFor($mime) ?? 'jpg');
|
||||
}
|
||||
|
||||
/** 把 $_FILES 的列式数组转成一列「一个文件一项」 */
|
||||
public static function restructure(array $files): array
|
||||
{
|
||||
$result = [];
|
||||
$count = count($files['name']);
|
||||
for ($i = 0; $i < $count; $i++) {
|
||||
if (empty($files['name'][$i])) {
|
||||
continue;
|
||||
}
|
||||
$result[] = [
|
||||
'name' => $files['name'][$i],
|
||||
'type' => $files['type'][$i],
|
||||
'tmp_name' => $files['tmp_name'][$i],
|
||||
'error' => $files['error'][$i],
|
||||
'size' => $files['size'][$i],
|
||||
];
|
||||
}
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user