如何解决Typo3的PHP RuntimeException“无法打开日志文件”错误

环境与问题 #

Ubuntu 20 系统，Apache2 作为Web服务器，已通过Composer安装TYPO3 11，PHP 7.4和MariaDB运行正常，但访问站点时出现HTTP 500错误，PHP抛出致命错误：Uncaught RuntimeException: Could not open log file。

安装步骤 #

在用户主目录执行以下命令：

composer create-project typo3/cms-base-distribution:^11 project
composer install --no-dev

当前目录结构 #

-rw-rw-r--  1 sudoUser sudoUser   1371 Nov 13 20:36 composer.json
-rw-rw-r--  1 sudoUser sudoUser 271237 Nov 13 20:36 composer.lock
drwxrwsr-x  3 sudoUser sudoUser   4096 Nov 13 20:36 config/
drwxrwxr-x  6 sudoUser sudoUser   4096 Nov 13 20:31 project/
drwxrwxrwx  6 sudoUser sudoUser   4096 Nov 14 09:00 public/
drwxrwsr-x  7 sudoUser sudoUser   4096 Nov 13 20:36 var/
drwxrwxr-x 24 sudoUser sudoUser   4096 Nov 13 20:36 vendor/

public目录结构 #

-rw-rw-r-- 1 sudoUser sudoUser  815 Nov 13 20:36 index.php
drwxrwxr-x 3 sudoUser sudoUser 4096 Nov 13 20:36 typo3/
drwxrwxr-x 3 sudoUser sudoUser 4096 Nov 13 20:36 typo3conf/
drwxrwsr-x 3 sudoUser sudoUser 4096 Nov 13 20:36 typo3temp/

Apache符号链接配置 #

在/var/www/html中创建指向TYPO3的符号链接：

lrwxrwxrwx 1 root root   25 Nov 14 14:49 index.php -> typo3src/public/index.php
lrwxrwxrwx 1 root root   31 Nov 14 14:48 typo3src -> /home/sudoUser/t3newProject//

错误日志（/var/log/apache2/error.log） #

[Mon Nov 14 14:53:47.615281 2022] [php7:warn] [pid 81236] [client 188.102.130.86:55812] PHP Warning:  fopen(/home/sudoUser/t3newProject/var/log/typo3_3a57bb40f2.log): failed to open stream: Permission denied in /home/sudoUser/t3newProject/public/typo3/sysext/core/Classes/Log/Writer/FileWriter.php on line 181
[Mon Nov 14 14:53:47.615336 2022] [php7:error] [pid 81236] [client 188.102.130.86:55812] PHP Fatal error:  Uncaught RuntimeException: Could not open log file "/home/sudoUser/t3newEFFORT/var/log/typo3_3a57bb40f2.log" in /home/sudoUser/t3newProject/public/typo3/sysext/core/Classes/Log/Writer/FileWriter.php:183
Stack trace:
#0 /home/sudoUser/t3newProject/public/typo3/sysext/core/Classes/Log/Writer/FileWriter.php(113): TYPO3\CMS\Core\Log\Writer\FileWriter->openLogFile()
#1 /home/sudoUser/t3newProject/public/typo3/sysext/core/Classes/Log/Writer/FileWriter.php(72): TYPO3\CMS\Core\Log\Writer\FileWriter->setLogFile()
#2 /home/sudoUser/t3newProject/public/typo3/sysext/core/Classes/Utility/GeneralUtility.php(3221): TYPO3\CMS\Core\Log\Writer\FileWriter->__construct()
#3 /home/sudoUser/t3newProject/public/typo3/sysext/core/Classes/Log/LogManager.php(145): TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance()
#4 /home/sudoUser/t3newProject/public/typo3/sysext/core/Classes/Log/LogManager.php(106): TYPO3\CMS\Core\Log\LogManager->setWritersForLogger()
#5 /home/sudoUser/t3newProject/public/typo3/sysext/cor in /home/sudoUser/t3newProject/public/typo3/sysext/core/Classes/Log/Writer/FileWriter.php on line 183

疑问 #

猜测问题与文件权限有关，但不清楚需要为哪些文件夹、文件或服务设置什么权限；另外，错误日志中提到的/home/sudoUser/t3newEFFORT/var/log目录实际不存在，请问该如何调整？

1. 修正目录名称笔误 #

错误日志中出现的t3newEFFORT是明显笔误，应为t3newProject。检查以下配置文件中的路径：

• config/system/additional.php或config/system/settings.php中的日志路径配置
• public/typo3conf/LocalConfiguration.php里的LOG相关配置项，确保路径指向/home/sudoUser/t3newProject/var/log/

2. 修复文件与目录权限 #

Apache在Ubuntu下默认以www-data用户运行，需确保TYPO3可写目录对该用户有读写权限：

步骤1：设置目录所属用户组 #

sudo chown -R sudoUser:www-data /home/sudoUser/t3newProject/

步骤2：调整关键目录权限 #

# 给var目录（日志、缓存存储目录）设置可写权限
sudo chmod -R 775 /home/sudoUser/t3newProject/var/
# 给public/typo3temp目录设置可写权限
sudo chmod -R 775 /home/sudoUser/t3newProject/public/typo3temp/
# 给public/typo3conf目录设置可写权限（用于扩展配置）
sudo chmod -R 775 /home/sudoUser/t3newProject/public/typo3conf/

步骤3：替换符号链接（可选） #

符号链接可能导致权限继承问题，建议直接修改Apache虚拟主机配置，指向TYPO3的public目录：

<VirtualHost *:80>
    ServerName your-domain.com
    DocumentRoot /home/sudoUser/t3newProject/public/

    <Directory /home/sudoUser/t3newProject/public/>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/typo3-error.log
    CustomLog ${APACHE_LOG_DIR}/typo3-access.log combined
</VirtualHost>

修改后重启Apache：

sudo systemctl restart apache2

3. 确保日志目录存在 #

如果var/log目录不存在，手动创建并设置权限：

mkdir -p /home/sudoUser/t3newProject/var/log/
sudo chown sudoUser:www-data /home/sudoUser/t3newProject/var/log/
sudo chmod 775 /home/sudoUser/t3newProject/var/log/

内容的提问来源于stack exchange，提问作者Paul