php 8.6会对scandir()的非法sorting_order抛出valueerror。目录列表接口应把asc、desc、none等业务名称映射成合法常量,再处理目录读取和输出错误,而不是把任意请求整数直接传给scandir。下面的示例只列出服务端固定目录中的普通文件,不提供客户端自选路径或文件下载功能。

合法值来自SCANDIR_SORT系列常量,不是任意整数。
固定目录并映射排序名称
先在脚本旁准备由服务管理的files目录。目录路径写在服务端,调用者只能选择排序方式;即使排序参数合法,也不能因此开放任意磁盘路径。
<?php header('Content-Type: application/json; charset=utf-8');
$orders = ['asc' => SCANDIR_SORT_ASCENDING,
'desc' => SCANDIR_SORT_DESCENDING, 'none' => SCANDIR_SORT_NONE];
$choice = $_GET['sort'] ?? 'asc';
if (!is_string($choice) || !array_key_exists($choice, $orders)) {
http_response_code(400);
echo json_encode(['error' => 'sort只接受asc、desc或none']);
exit;
}
try {
$directory = realpath(__DIR__ . '/files');
if ($directory === false || !is_dir($directory)) {
throw new RuntimeException('目录未准备');
}
$names = scandir($directory, $orders[$choice]);
if ($names === false) throw new RuntimeException('目录读取失败');
$files = [];
foreach ($names as $name) {
if ($name === '.' || $name === '..') continue;
$path = $directory . DIRECTORY_SEPARATOR . $name;
if (!is_link($path) && is_file($path)) $files[] = $name;
}
echo json_encode(['files' => $files], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
} catch (Throwable $error) {
http_response_code(500);
echo json_encode(['error' => '无法生成文件列表']);
}
将脚本置于受控测试Web环境,请求?sort=asc、?sort=desc和?sort=none,分别检查文件名顺序;再请求非法名称或数组参数,确认返回400且不调用扫描。目录不存在、权限问题或文件名无法按UTF-8编码时,进入服务端错误路径;公开响应不输出磁盘完整路径。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

升级后应按参数契约校验,而不是只等待目录访问警告。
排序、权限和结果完整性分别验证
none表示不排序,不保证每次扫描都返回稳定顺序;需要分页或稳定结果时,应固定排序规则并设计快照,而不是把文件系统顺序当作接口契约。scandir会把目录内容读入数组,大目录需要另外设计资源预算。目录可列出不代表文件可下载或用户有权查看,认证、授权以及响应缓存仍属于应用自己的职责。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










