README

适用于 Windows OS 的 Xampp 虚拟主机和自签名 SSL 证书管理系统（控制台模式）。

文档语言 >>> (英语 | 越南语 )

有人曾经问我

如何在 Windows OS 上配置和管理 Xampp 的虚拟主机？

其他人也问过

我如何最快、最简单地添加自签名 SSL 证书到 Xampp 虚拟主机，并轻松管理它们，而无需使用 OPENSSL 命令的麻烦？

因此，这个项目应运而生，旨在加强 Xampp，帮助用户充分利用 Xampp 的固有资源，尽可能快、尽可能容易地实现上述目的。

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

此项目的功能

• 创建虚拟主机。
• 删除现有的虚拟主机。
• 显示现有虚拟主机的信息。
• 列出所有现有虚拟主机。
• 将 SSL 证书添加到现有虚拟主机。
• 删除现有虚拟主机的 SSL 证书。
• 更改现有虚拟主机的 Document Root。
• 停止 Xampp Apache Httpd。
• 启动 Xampp Apache Httpd。
• 重启 Xampp Apache Httpd。

概述

查看以下主题之一以了解更多关于 Xampp vHosts Manager 的信息。

• Xampp vHosts Manager
• 此项目的功能
• 概述
  • 兼容性
  • 要求
  • 安装
    • 通过 Composer Create-Project
    • 通过手动下载
  • 更新
  • 用法
    • 显示帮助信息
    • 创建新的虚拟主机
    • 显示现有虚拟主机的信息
    • 列出所有现有虚拟主机
    • 删除现有的虚拟主机
    • 将 SSL 证书添加到现有的虚拟主机
    • 删除现有虚拟主机的 SSL 证书
    • 更改现有虚拟主机的 Document Root
    • 停止 Apache Httpd
    • 启动 Apache Httpd
    • 重启 Apache Httpd
    • 注册应用程序路径
    • 授予 Windows 主机文件的必要权限
  • 配置
  • 许可证
  • 感谢使用

兼容性

• Xampp vHosts Manager 与所有使用 PHP 5.4 或更高版本的 Xampp 版本兼容。
• 目前，此项目尚不支持便携式 Xampp 版本。

要求

Xampp vHosts Manager 充分利用 Xampp 中包含的所有内容，无需更多。因此，您只需要以下几样东西

• 已安装 Xampp（当然）。
• 将 Xampp PHP 目录的路径添加到 Windows 环境变量中。
• （可选）安装 Composer。

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

安装

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

通过 Composer Create-Project

• 打开一个终端。
• 导航到您想要安装 Xampp vHosts Manager 的目录。
• 运行 composer create-project 命令

$ composer create-project jackiedo/xampp-vhosts-manager xvhm "1.*"

通过手动下载

• 下载最新版本 最新版本
• 将存档提取到共享位置 (例如：D:\xvhm)。注意：不应放置在 C:\Program Files 或需要管理员权限才能修改配置文件的任何其他位置。
• 以管理员模式打开终端 (运行为管理员)。
• 导航到您放置 Xampp vHosts Manager 的目录 (例如：cd /D D:\xvhm)。
• 执行命令 xvhost install 并按照要求的步骤进行。
• 退出终端（以删除临时环境变量）。

注意：请参阅此处了解如何以管理员身份打开命令提示符。

更新

目前，Xampp vHosts Manager 没有自动更新机制，我们必须手动分步进行，如下所示

• 备份 Xampp vHosts Manager 目录中的 settings.ini 文件和 cacert 文件夹到其他位置。
• 删除 Xampp vHosts Manager 应用程序目录中的所有文件和子文件夹。
• 下载最新的发布版本并将其提取到 Xampp vHosts Manager 应用程序目录中。
• 将之前备份的 settings.ini 文件和 cacert 文件夹复制回 Xampp vHosts Manager 应用程序目录。

用法

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

显示帮助信息

语法

$ xvhost help

创建新的虚拟主机

语法

$ xvhost new [HOST_NAME]

示例

$ xvhost new demo.local

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

显示现有虚拟主机的信息

语法

$ xvhost show [HOST_NAME]

示例

$ xvhost show demo.local

列出所有现有虚拟主机

语法

$ xvhost list

删除现有的虚拟主机

语法

$ xvhost remove [HOST_NAME]

示例

$ xvhost remove demo.local

将 SSL 证书添加到现有的虚拟主机

语法

$ xvhost add_ssl [HOST_NAME]

示例

$ xvhost add_ssl demo.local

删除现有虚拟主机的 SSL 证书

语法

$ xvhost remove_ssl [HOST_NAME]

示例

$ xvhost remove_ssl demo.local

更改现有虚拟主机的 Document Root

语法

$ xvhost change_docroot [HOST_NAME]

示例

$ xvhost change_docroot demo.local

停止 Apache Httpd

语法

$ xvhost stop_apache

启动 Apache Httpd

语法

$ xvhost start_apache

重启 Apache Httpd

语法

$ xvhost restart_apache

注册应用程序路径

此功能允许您将 Xampp vHosts Manager 应用程序目录的路径注册到 Windows 路径环境变量中。通常，您很少需要这样做。它仅在您需要更改 Xampp vHosts Manager 的应用程序目录名称或将它移动到另一个位置时才有用。

要这样做，在更改目录后，在命令提示符中导航到应用程序目录的新位置，并运行以下命令

语法

$ xvhost register_path

注意：您需要接受以管理员权限执行此过程。

授予 Windows 主机文件的必要权限

此功能将授予 修改、读取和执行、读取、写入 权限给 Windows 主机 文件中的 用户 账户。这使得 Xampp vHosts Manager 每次创建虚拟主机时都能将其添加到 Windows 主机 文件中。

语法

$ xvhost grantperms_winhosts

注意：您需要接受以管理员权限执行此过程。

配置

所有配置都存储在一个名为 settings.ini 的 ini 文件中，该文件位于 Xampp vHosts Manager 应用程序目录中。此文件的结构如下

[Section_1]
setting_1 = "value"
setting_2 = "value"

[Section_2]
setting_1 = "value"
setting_2 = "value"
...

XVHM 的整个配置包括

[DirectoryPaths]
;The path to your Xampp directory.
Xampp = "D:\xampp"

[Suggestions]
;The path to directory used to propose as DocumentRoot config in vhost config file each vhost creation process.
;The variable {{host_name}} is used as virtual host name placeholder.
DocumentRoot = "D:\www\{{host_name}}"

;The email used to propose as ServerAdmin config in vhost config file each vhost creation process.
AdminEmail = "anhvudo@gmail.com"

[ListViewMode]
;The number of records will be displayed on each page when listing the existing virtual hosts.
RecordPerPage = "3"

许可证

MIT © Jackie Do

感谢使用

希望这个包对您有所帮助。