TYPO3 11.5/10.4 Composer/zip方式安装失败问题咨询

• 近期有大量开发者正常安装并使用TYPO3，10.4、11.5均为官方长期支持的稳定版本，不存在无法安装、无法使用的情况。

所有报错均来自安装包选择错误、安装模式和操作步骤不匹配、基础环境配置问题：

• 你下载的缺失public文件夹的zip包是TYPO3核心源码包，不是面向终端用户的预构建发行包，本身就不包含完整的运行目录结构。你参考的软链接创建步骤属于传统源码部署流程，和Composer安装模式的目录规则完全不通用，硬套步骤必然出问题。
• 11.5版本安装后后端404，本质是Web服务器根目录配置错误：Composer模式安装的TYPO3，站点根目录必须指向项目内的public文件夹，如果根目录指向项目外层文件夹，请求根本不会进入TYPO3的路由解析流程，自然不会在TYPO3日志里留下报错记录。
• 10.4版本Composer安装返回255错误、PDOStatement.php第67行报错，是PHP环境未正常加载pdo_mysql扩展、或数据库服务未启动导致的，脚本在post-autoload-dump阶段会做数据库连接前置检测，环境不符合要求就会直接中断。
• 安装前找不到对应配置文件属于正常现象，TYPO3的配置文件会在安装向导走完数据库连接步骤后自动生成，不需要提前手动创建。

Composer安装（官方推荐，适配10.4/11.5全版本） #

• 提前准备符合要求的运行环境：10.4版本适配PHP 7.2-7.4，11.5版本适配PHP7.4-8.1，需开启fileinfo、pdo_mysql、curl、gd、mbstring、zip扩展，同时准备好MySQL5.7+/MariaDB10.3+数据库服务，提前配置好Composer避免下载依赖超时。
• 进入项目存放目录，执行对应版本的项目创建命令：
  安装11.5版本执行：

  composer create-project typo3/cms-base-distribution:^11.5 my-typo3-site
  

  安装10.4版本执行：

  composer create-project typo3/cms-base-distribution:^10.4 my-typo3-site
  

• 依赖安装完成后，项目目录下会自动生成public文件夹，无需手动创建软链接。直接将Web服务器（Apache/Nginx/本地集成环境）的站点根目录绑定到项目路径/public，Apache会自动识别目录下的伪静态规则，Nginx需手动配置对应重写规则。
• 访问绑定的站点域名即可自动进入安装向导，按提示填写数据库信息、创建管理员账号即可完成安装，后端访问地址为你的站点域名/typo3。

压缩包安装（仅适合快速测试，不推荐生产使用） #

• 不要下载源码仓库的压缩包，需选择官方预构建的发行包，这类包解压后根目录直接包含入口文件、typo3核心文件夹，不存在缺失public目录的问题，也不需要执行软链接创建命令。
• 将解压后的所有文件放入Web服务器站点根目录，给对应目录配置写入权限，访问站点域名即可进入安装向导。

• 不要混用不同安装模式的操作步骤：Composer模式下所有目录结构会在依赖安装时自动生成，不需要手动下载源码、创建软链接；传统压缩包发行版不需要执行Composer命令，解压即可运行。
• 参考文档时注意匹配对应安装模式、对应版本，不同大版本、不同安装方式的操作步骤不能通用。

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