【问题标题】：How to unlock TYPO's Install Tool (/typo3/install.php)?如何解锁 TYPO 的安装工具 (/typo3/install.php)？
【发布时间】：2019-09-06 10:49:49
【问题描述】：

在“typo3conf”文件夹中添加一个名为“ENABLE_INSTALL_TOOL”的空文本文件后，当我访问主机名/typo3/install.php 时，安装工具仍处于锁定状态。

一些背景信息：我刚刚将所有 TYPO3 文件上传到远程主机，并试图让它显示 TYPO3 网站。当我登录后端时，出现以下错误：

1533822084 TYPO3\CMS\Core\Crypto\PasswordHashing\InvalidPasswordHashException

配置的默认哈希方法 TYPO3\CMS\Core\Crypto\PasswordHashing\Argon2iPasswordHash 不可用。如果实例刚刚升级，请登录位于typo3/install.php 的独立安装工具可以解决这个问题。跟随更多详情请点击 wiki 链接。

此错误涉及此 wiki 页面：https://wiki.typo3.org/Exception/CMS/1533822084

这里建议：

调用独立安装工具并登录一次。这应该检测到 argon2i 不可用，并将配置不同的默认散列机制。之后应该可以进行后端登录。

自从安装工具被锁定以来，我一直在坚持什么。

【问题讨论】：

您写道：“我刚刚将所有 TYPO3 文件上传到远程主机，并试图让它显示 TYPO3 网站。”你是怎么上传的？您不能通过 FTP 上传 TYPO3。你肯定需要 SSH。
我用的是SFTP，应该没问题:)
不，绝对不行！
SFTP 使用 SSH，所以我不确定你的意思。

标签： typo3 typo3-9.x

【解决方案1】：

当您第一次访问地址https://yoursite.com/typo3/install.php 时，您应该会看到以下屏幕：

正如您所写，您必须在 TYPO3 安装的文件夹 /typo3conf/ 中添加一个文件 ENABLE_INSTALL_TOOL（不带扩展名）；该文件可以为空。

完成此操作并刷新同一页面后，您应该会看到：

如果您没有更改（推荐），密码应该与您在安装过程中创建的第一个管理员用户的密码相同。

如果您已更改但不记得了，请按照屏幕上的说明进行操作。

【讨论】：

【解决方案2】：

请参考官方安装指南：

https://docs.typo3.org/m/typo3/guide-installation/master/en-us/QuickInstall/GetAndUnpack/Index.html

您需要通过 SSH 访问远程服务器。 FTP 或 SFTP 是不够的，因为没有上传符号链接。

您需要将 zip 或 tar.gz 文件传输到服务器并在那里解压。切勿在您的机器上解压它们并将文件传输到服务器。

【讨论】：

【解决方案3】：

我在 CentOS 8 的 Typo3 10 中遇到了同样的问题

argon2 密码哈希算法仅在 PHP >= 7.4 中，在 CentOS 8 的先前版本中没有。

在 7.2 / 7.3 中，argon2 是“标准”扩展的一部分，并且在 RH 构建中被禁用，因为 libargon2 在 RHEL / CentOS 中不可用

因此，如果您可以升级到 PHP 7.4，它会起作用。

PHP 7.3 中的替代方法在 LocalConfiguration.php 中设置

'installToolPassword' => '$2y$12$kB0JLQcbADywtxtxjoBoUOrCSk0RHhh/zuKDbFrtAYlr8fUlZ/1Em',
'passwordHashing' => [
        'className' => 'TYPO3\\CMS\\Core\\Crypto\\PasswordHashing\\BcryptPasswordHash',

打开安装工具ursite/typo3/install.php 密码是“密码”（上面的 installToolPassword 哈希值）

现在创建一个新管理员并使用它来登录后端并重置其他管理员的密码

【讨论】：