README

在Windows操作系统上使用和切换不同版本的PHP。

Xampp是一个易于安装的Apache发行版，包含MariaDB、PHP和Perl。它已经存在了10多年——背后有一个庞大的社区。目前，还有许多其他具有更多优势的应用程序被推出。然而，许多人仍然热爱Xampp，因为它易于使用。问题是，相当多的人还没有充分利用Xampp的全部功能。

因此，我创建了两个独立的项目，以充分利用Xampp的功能，添加许多人希望在Xampp中拥有的功能。

• 其中一个是允许使用不同版本的PHP的功能（本项目）。
• 另一个是vhosts管理功能，附带自签名SSL证书（请参见此处）。

通过本项目，使用和切换Xampp的不同PHP版本变得简单。这对于那些想要确保他们的应用程序在不同的PHP平台上平稳运行，或者那些正在研究PHP编程的人来说将非常有用。

注意：目前本项目仅支持Windows用户。

本项目特色

• 为单个Xampp版本安装和管理各种PHP构建。
• 快速轻松地在不同版本的PHP之间切换。

概述

查看以下主题之一以了解有关Xampp PHP Switcher的更多信息。

• Xampp PHP Switcher
• 本项目特色
• 概述
  • 兼容性
  • 要求
  • 安装
    • 通过Composer创建项目
    • 通过手动下载
  • 更新
  • 将其他PHP版本添加到您的Xampp中
    • 重要提示
    • 添加构建的逐步过程
      • 检查当前构建的架构信息
      • 下载兼容的PHP构建
      • 添加最近下载的PHP构建
    • 添加PHP构建的过程背后的原理
    • 更新未来添加PHP构建的过程
  • 使用方法
    • 显示帮助信息
    • 显示当前PHP版本的信息
    • 显示存储库中现有PHP版本的信息
    • 列出存储库中所有现有的PHP版本
    • 从存储库中移除现有的PHP版本
    • 将一个PHP版本添加到存储库
    • 切换到要使用的特定PHP版本
  • php.ini文件编辑
  • 许可证

兼容性

• 兼容所有使用PHP 5.4或更高版本的已安装Xampp版本。
• 目前，本项目还不支持便携式Xampp版本。

要求

Xampp PHP Switcher充分利用了Xampp中包含的内容，无需更多。所以，你只需要以下几样东西

• 成功安装了Xampp。
• 已将Xampp PHP目录的路径添加到Windows路径环境变量中。
• (可选) 已安装Composer。

注意：请参见此处了解如何添加Windows路径环境变量。

安装

有两种安装方法，通过Composer或手动下载。如果您已经安装了Composer，建议您使用通过Composer的方法。

通过Composer创建项目

• 打开一个终端。
• 导航到您要安装Xampp PHP Switcher的目录(例如: cd /D D:\)。
• 运行composer create-project命令

$ composer create-project jackiedo/xampp-php-switcher xphp "1.*"

通过手动下载

• 下载最新版本。
• 将存档解压到共享位置 （例如：D:\xphp）。注意：不要放在 C:\Program Files 或需要管理员权限修改配置文件的任何位置。
• 以管理员模式打开终端 （以管理员身份运行）。
• 导航到放置 Xampp PHP Switcher 的目录 （例如：cd /D D:\xphp）。
• 执行命令 xphp install 并按照所需的步骤操作。
• 退出终端（以移除临时环境变量）。

注意：有关如何在 Windows 8.1 中以管理员身份打开命令提示符的说明，请参阅 此处。

更新

目前，Xampp PHP Switcher 没有自动更新机制，我们必须按照以下步骤手动更新：

• 将 Xampp PHP Switcher 应用程序文件夹中的 settings.ini 文件备份到其他位置。
• 删除 Xampp PHP Switcher 应用程序文件夹中的所有文件和子文件夹。
• 下载最新的版本 此处 并将其解压到 Xampp PHP Switcher 应用程序文件夹中。
• 将之前备份的 settings.ini 文件复制回 Xampp PHP Switcher 应用程序文件夹。

将其他PHP版本添加到您的Xampp中

重要提示

成功安装 Xampp PHP Switcher 后，默认情况下，您将拥有 Xampp 内置的 PHP 版本。为了使用其他版本的 PHP，我们将继续将这些构建添加到存储库。这将很容易完成。但您需要注意以下要求：

• 只能添加从 Xampp 官方网站下载的构建，或者已添加到 Xampp PHP Switcher 存储库的构建。
• 只能将具有相同架构（32 或 64 位运行时）的构建添加到当前构建。

添加构建的逐步过程

检查当前构建的架构信息

执行以下命令

$ xphp info current

查看架构部分的信息并记住它。

下载兼容的PHP构建

• 从 此处 的官方下载页面下载兼容的 Xampp 构建。
• 下载时，请注意要下载的构建架构必须与我们刚才看到的当前构建架构相同。
• 不要下载便携式构建，也不要下载安装程序 (.exe)。
• 下载后，将其解压到我们电脑上的某个位置，并注意新解压的 Xampp 目录中 PHP 目录的路径。

要下载的兼容项目

添加最近下载的PHP构建

执行 xphp add 命令

$ xphp add "drive:\path\to\above\xampp-php-directory"

或者用第二种语法更简单

$ xphp add

然后根据要求提供上述链接。

注意：如果使用第一种语法，应该在双引号（")中放置路径，以避免空格的影响造成的错误。

现在我们可以使用许多不同的 PHP 版本。我们可以使用 xphp switch 命令在版本之间切换。

添加PHP构建的过程背后的原理

当我们使用 xphp add 命令时，Xampp PHP Switcher 会执行以下操作：

• 将包含 PHP 构建的整个目录复制到 Xampp 中的存储库。
• 对一些新 PHP 构建文件的路径进行标准化，以便它能够与您的 Xampp 正确工作。
• 创建一个包含 PHP 构建存档信息的文件（带有 ".storage" 名称），并将其放置在存储库中新构建的目录中。
• 创建一个名为 "xampp-httpd-php(x).conf" 的文件（x 是相应的 PHP 主版本），以便您的 Xampp 中的 Apache 能够处理新的 PHP 构建。基于此，您可以切换到不同的 PHP 版本。

更新未来添加PHP构建的过程

标准化路径的过程是基于项目目录 "src" 文件夹中名为 "need_standardize.lst" 的文件执行的。目前，该文件支持从版本 5.4（Xampp 1.8.3）到 8.0（Xampp 8.0.x）的 PHP 构建的路径标准化。

每次Xampp发布新版本时，此文件将进行检查和更新。您只需复制此文件的全部新内容，并将其覆盖在Xampp PHP Switcher目录中的现有文件即可。或者，您可以根据以下说明更新Xampp PHP Switcher：此处。

使用方法

由于在安装过程中已将Xampp PHP Switcher应用程序目录的路径添加到Windows路径环境变量中，现在您可以在任何地方打开终端（不再需要以管理员模式打开），并执行以下任一xphp命令。

显示帮助信息

语法

$ xphp help

显示当前PHP版本的信息

语法

$ xphp info current

显示存储库中现有PHP版本的信息

语法

$ xphp info [VERSION]

示例

$ xphp info 5.6.40

注意：VERSION参数是可选的。如果您未将此参数传递给命令语句，您稍后还会被要求输入此信息。

列出存储库中所有现有的PHP版本

语法

$ xphp list

从存储库中移除现有的PHP版本

语法

$ xphp remove [VERSION]

示例

$ xphp remove 5.6.40

将一个PHP版本添加到存储库

语法

$ xphp add [PATH_TO_ANOTHER_XAMPP_PHP_DIRECTORY]

示例

$ xphp add "D:\download\xampp-win32-5.5.19-0-VC11\php"

切换到要使用的特定PHP版本

语法

$ xphp switch [VERSION]

示例

$ xphp switch 5.5.19

php.ini文件编辑

一旦您将各种PHP版本添加到Xampp中，它们将被放置在Xampp目录下名为"phpRepository"的目录中的仓库中。并且它们将各自拥有"php.ini"配置文件。如果您需要编辑PHP的配置，您必须编辑仓库中相应版本的每个"php.ini"文件。

许可证

MIT © Jackie Do