如何在本地 PHP 开发设置中设置 DOCUMENT_ROOT 和站点根目录？

Question

我正在为一个拥有在线网站的人做一份工作。 这对我来说是一个陌生的网站，我正在慢慢地研究奇怪的代码。 我本地有 MAMP，我的 http://localhost/ 有许多来自其中的客户端文件夹。 这段代码中有很多 $_SERVER['document_root'] 命令和引用，例如 ，它们在我本地的 PHP 开发区域中丢失了。

我如何轻松地将 document_root 引用设置为应有的样子（尽管只是在本地，但不想弄乱站点文件，因为我需要再次上传它们并且不想破坏实时站点！并且有没有一种间接设置方法，PHP 认为站点的根目录是这样图像的 src 引用“/images/...”将正确显示...我的本地 PHP 开发 URL 该站点是： http://localhost:8888/_CLIENTS/clientsite/www/ ...但是在代码中 '/ ' 在 '/images/...' 开头引用 http://localhost:8888/

谢谢你。

Answer 1

@Eddie 的回答对我帮助很大，但我仍然需要做一些额外的研究才能在 OSX 上使用 XAMPP 为自己解决同样的问题。 我想我应该在这里添加完整的解决方案，以造福子孙后代。

首先，我将以下条目添加到 httpd-vhosts.conf（在 XAMPP 中的“etc/extra/”文件夹下）：

NameVirtualHost *:80

<VirtualHost *:80>
    ServerName localhost
    DocumentRoot "/Applications/xampp/xamppfiles/htdocs/"
</VirtualHost>
<VirtualHost *:80>
    ServerName client1.my-machine
    DocumentRoot "/Applications/xampp/xamppfiles/htdocs/clients/client1/"
</VirtualHost>
<VirtualHost *:80>
    ServerName client2.my-machine
    DocumentRoot "/Applications/xampp/xamppfiles/htdocs/clients/client2/"
</VirtualHost>

请注意，我专门使用通配符而不是“localhost”作为 VirtualHost url，并在我指定的位置添加了 ServerName 配置每个子域名。 另请注意，我使用了我的计算机名称（“my-machine”）而不是“localhost”——这样可以正确评估来自任何计算机（而不仅仅是 localhost）的所有请求。 我在 OSX 中进行开发，但通过 Parallels 在各种虚拟机中测试浏览器。 使用这种方法，我可以从网络上的任何计算机或虚拟机访问 http://client1.my-machine。 指定“localhost”后，它只能在我的开发计算机上运行。

注意：第一个 VirtualHost 条目用作默认值（如下所述：http://httpd.apache.org/docs/2.2/vhosts/name-based.html）并且是必需的，以便请求不会默认发送到自定义站点之一。

我还将权限设置添加到 httpd.conf，如 @Eddie 的回答。 这并不总是必需的，但我遇到了 2 个不同的情况，需要进行此更改：

• 将新站点置于默认 XAMPP http 根目录之外的目录中（基本上任何可通过 http 访问的路径都必须设置显式权限） ）
• 为设置为虚拟主机的站点（在默认 http 路径下）添加 mod_rewrite 规则，我收到错误“.htaccess：此处不允许 RewriteEngine”。 阅读 httpd.conf 中有关 AllowOverride 选项的注释可以让错误的原因显而易见，但我之前忽略了这一点。 将其更改为“全部”修复了错误。

请注意，在编辑 httpd.conf 时，您可能需要取消注释以下行（默认情况下已为我注释掉），否则上面所做的 vhosts 更改将不会生效：

# Virtual hosts
Include /Applications/xampp/etc/extra/httpd-vhosts.conf

最后，我还必须将自定义域名添加到我的主机文件如上面的评论所述。 在 OSX 上，您可以通过编辑“/private/etc/hosts”（在 Windows 上为“Windows/System32/drivers/etc/hosts”）并添加以下行来完成此操作：

127.0.0.1   my-machine
127.0.0.1   client1.my-machine
127.0.0.1   client2.my-machine

注意：默认的 OSX Finder UI，隐藏文件夹（包括 /private）不可见。 您可以通过破解内部 Finder 选项（详细信息请参阅 Google）来永久更改此设置，或者更简单地进行偶尔的更改，只需使用“转到 > 转到文件夹”菜单选项，该选项将允许您直接按名称打开隐藏文件夹。 就我个人而言，我使用一个名为 PathFinder 的第三方 OSX shell，我衷心推荐它（它值得小许可证费用）。 它包括一个隐藏/显示隐藏文件的菜单选项以及许多其他有用的功能。

麻烦的一件事是，我还必须在 Windows VM 主机文件中添加指向我的物理开发机器的匹配条目，以便 URL 可以通过 Apache/OSX 解析：

192.168.1.5 client1.my-machine
192.168.1.5 client2.my-machine

我不需要单独的机器名称条目（自动解析）但是如果没有这些主机条目，向其中添加子域将无法正确解析。 有时我的 Mac 的 IP 会发生变化（通过 DHCP），这确实会带来麻烦，但这只是一个小麻烦。 我假设我可以将其设置为不需要这些 IP，但我无法弄清楚并准备继续:)（如果有人知道答案，请发表评论）

现在我有多个客户端站点在一个中运行放置并可从我的所有开发/测试环境访问。 希望这对其他人有帮助。

Answer 2

我推荐的是虚拟主机，这样您就可以在本地提供“外部站点”，而不会干扰您的默认 Web 服务器。

• 本地主机 -> 你的起始页或其他
• alien.localhost -> 客户站点，无论您想要什么路径/文档根。
• x.localhost-> 另一个站点

在 apaches 全局配置文件或包含的 vhost.conf 中；

NameVirtualHost localhost:80
# the mysql tool's url
<VirtualHost phpmyadmin.localhost:80>
# and absolute path
DocumentRoot "/srv/www/phpMyAdmin/"
</VirtualHost>

#Same for the Client Site
<VirtualHost foo.localhost:80>
DocumentRoot "/path/to/desired/webroot/"
</VirtualHost>

首先指定以下内容来控制权限并设置总体全局站点

您可以通过在 apache 的全局服务器配置中

DocumentRoot "/srv/www/htdocs"
#
# Configure the DocumentRoot Properties
#
<Directory "/srv/www/htdocs"> 
    Options All
    # AllowOverride controls what directives may be placed in .htaccess files.
    # It can be "All", "None", or any combination of the keywords:
    #   Options FileInfo AuthConfig Limit
    AllowOverride All
    # Controls who can get stuff from this server.
    Order allow,deny
    Allow from all
</Directory>
#
# Configure Sub-Domain Properties. This prevents those nasty 403 errors
#
 
# mysql administration tool
<Directory "/srv/www/phpMyAdmin/">
    Options Indexes MultiViews
    AllowOverride All
    Order allow,deny
    Allow from all
</Directory>
 
# a client web site built with CakePHP
<Directory "/home/eddie/workspace/Digital_Business/app/webroot/">
    Options All
    AllowOverride All
    Order allow,deny
    Allow from all
</Directory>

Answer 3

对于当前进程，您可以执行

$_SERVER["document_root"] = "whatever";

不过要小心。

Answer 4

这是特定于服务器的设置。 如果您正在运行 Apache，您所需要做的就是编辑 httpd.conf 文件（在基于 Unix 的系统上，它应该位于 /etc/apache2/httpd .conf 或 /etc/httpd/httpd.conf，具体取决于您拥有的 Apache 版本）。 文件中应该有一行如下所示：

#
# DocumentRoot: The directory out of which you will serve your
# documents. By default, all requests are taken from this directory, but
# symbolic links and aliases may be used to point to other locations.
#
DocumentRoot "/whatever/your/document/root/is"

从技术上讲，Eli 的方法也有效，但一般来说，我认为编辑服务器变量并不是一个好主意。

Answer 5

也许您会发现以下网站很有用。 有一些简单易懂的教程向您展示了要操作哪些设置才能让您满意。 我发现那里有很多解释。

Tanguay 的教程