Slim框架ChatApp项目报错：无法找到指定文件或目录

问题概述 #

使用命令 php -S localhost:8888 -t public 启动本地服务后，访问 localhost:8888 出现以下错误：

require(C:\xampp\htdocs\ChatApp\public/../app/Routes/routes.php): Failed to open stream: No such file or directory in C:\xampp\htdocs\ChatApp\public\index.php on line 18

项目目录结构 #

ChatApp/
│
├── app/
│   ├── Controllers/
│   │   └── ApiController.php
│   │
│   ├── Models/
│   │   ├── GroupModel.php
│   │   └── MessageModel.php
│   │
│   ├── Routes/
│   │   └── routes.php
│   │
│   └── chatapp.sqlite
│
├── public/
│   ├── index.php
│   └── .htaccess
│
├── vendor/
│
├── composer.json
└── composer.lock

相关代码片段 #

public/index.php #

<?php
use Slim\Factory\AppFactory;

require __DIR__ . '/../vendor/autoload.php';

$containerBuilder = new \DI\ContainerBuilder();
$container = $containerBuilder->build();
AppFactory::setContainer($container);

$app = AppFactory::create();

$routes = require realpath(__DIR__ . '/../app/Routes/routes.php');
$routes($app);

$app->run();

app/Routes/routes.php #

<?php

use Slim\Routing\RouteCollectorProxy;
use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use App\Controllers\ApiController;
use App\Models\GroupModel;
use App\Models\MessageModel;

$app->group('/api', function (RouteCollectorProxy $group) {
    $group->get('/groups', ApiController::class . ':getGroups');
    $group->post('/groups', ApiController::class . ':createGroup');
    $group->post('/messages', ApiController::class . ':addMessage');
    $group->get('/messages/{group_id}', ApiController::class . ':getMessagesByGroup');
});

$app->addErrorMiddleware(true, true, true);

if (!file_exists('chatapp.sqlite')) {
    try {
        $pdo = new PDO('sqlite:chatapp.sqlite');
        $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);

        $pdo->exec('CREATE TABLE groups (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)');
    } catch (PDOException $e) {
        die('Veritabani olusturulurken veya baglanirken hata olustu: ' . $e->getMessage());
    }
} else {
    try {
        $pdo = new PDO('sqlite:chatapp.sqlite');
        $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
    } catch (PDOException $e) {
        die('Veritabanina baglanirken hata olustu: ' . $e->getMessage());
    }
}

$groupModel = new GroupModel($pdo);
$messageModel = new MessageModel($pdo);
$apiController = new ApiController($groupModel, $messageModel);

错误原因与解决步骤 #

核心问题分析 #

1. realpath() 函数在部分环境下可能因路径解析异常返回 false，导致 require 无法找到文件
2. routes.php 未按照 Slim 路由加载规范返回可调用的闭包函数，导致 $routes($app) 执行失败
3. 数据库文件使用相对路径，存在定位不准确的风险

1. 修复index.php路由加载路径 #

将index.php中加载路由的代码：

$routes = require realpath(__DIR__ . '/../app/Routes/routes.php');

修改为：

$routes = require __DIR__ . '/../app/Routes/routes.php';

说明：__DIR__ 是 public 目录的绝对路径，直接拼接相对路径可准确定位到 routes.php，避免 realpath() 的解析异常。

2. 重构routes.php结构 #

将所有逻辑包裹在闭包函数中并返回，适配index.php的调用逻辑，同时修正数据库路径：

<?php

use Slim\Routing\RouteCollectorProxy;
use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use App\Controllers\ApiController;
use App\Models\GroupModel;
use App\Models\MessageModel;

return function ($app) {
    $app->group('/api', function (RouteCollectorProxy $group) {
        $group->get('/groups', ApiController::class . ':getGroups');
        $group->post('/groups', ApiController::class . ':createGroup');
        $group->post('/messages', ApiController::class . ':addMessage');
        $group->get('/messages/{group_id}', ApiController::class . ':getMessagesByGroup');
    });

    $app->addErrorMiddleware(true, true, true);

    // 修正数据库文件绝对路径
    $dbPath = __DIR__ . '/../chatapp.sqlite';
    if (!file_exists($dbPath)) {
        try {
            $pdo = new PDO('sqlite:' . $dbPath);
            $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);

            $pdo->exec('CREATE TABLE groups (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)');
        } catch (PDOException $e) {
            die('Veritabani olusturulurken veya baglanirken hata olustu: ' . $e->getMessage());
        }
    } else {
        try {
            $pdo = new PDO('sqlite:' . $dbPath);
            $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
        } catch (PDOException $e) {
            die('Veritabanina baglanirken hata olustu: ' . $e->getMessage());
        }
    }

    $groupModel = new GroupModel($pdo);
    $messageModel = new MessageModel($pdo);
    $apiController = new ApiController($groupModel, $messageModel);
};

关键修改：

• 用 return function ($app) { ... } 包裹所有逻辑，让index.php能正确传入$app实例并执行
• 数据库路径改为 __DIR__ . '/../chatapp.sqlite'，确保无论服务器工作目录如何，都能定位到app目录下的sqlite文件

3. 验证文件存在性 #

确认 ChatApp/app/Routes/routes.php 文件真实存在，文件名与目录名的大小写和代码引用保持一致（避免跨平台兼容问题）。

完成以上修改后，重新运行 php -S localhost:8888 -t public 启动服务，访问 localhost:8888 即可正常加载应用。

内容的提问来源于stack exchange，提问作者Bahadır Çolak