README

这个小巧的包在Laravel项目中使用时，会重写Whoops的漂亮页面处理器中的文件链接。

当在虚拟机中运行项目时，Whoops生成的链接将指向虚拟机内的文件路径，这些路径在主机环境中不可访问。为了使这些链接工作，它们必须被重写，以便指向主机机器上的正确文件。使用此包，修复这些链接非常简单。

安装

在项目根目录下，执行以下操作

composer require levacic/laravel-whoops-editor-link:~1

或者，您可以在安装包时指定当前可用的包版本，例如 ~1.0.3。

之后，发布配置文件

php artisan config:publish levacic/laravel-whoops-editor-link

这将复制配置文件到 app/config/packages/levacic/laravel-whoops-editor-link/path.php，您应该为您的环境配置适当的路径。

例如，如果您的应用程序位于主机机器的 /home/username/www/application，而在虚拟机中，应用程序根目录位于 /var/www/sites/application，则您的配置应类似于以下内容

<?php

return [

	/**
	 * The path to the application root on the host machine.
	 *
	 * Don't use a trailing slash!
	 */
	'host' => '/home/username/www/application',

	/**
	 * The path to the application root on the guest machine.
	 *
	 * Don't use a trailing slash!
	 */
	'guest' => '/var/www/sites/application',

];

但是，如果您这样做，您将在应用程序仓库中硬编码应用程序路径，这被认为是不良实践。配置此包的推荐方法是使用 Laravel的环境变量 配置路径，例如，变量命名为 APP_ROOT_HOST 和 APP_ROOT_GUEST，并设置配置以使用这些变量

<?php

return [

	/**
	 * The path to the application root on the host machine.
	 *
	 * Don't use a trailing slash!
	 */
	'host' => getenv('APP_ROOT_HOST'),

	/**
	 * The path to the application root on the guest machine.
	 *
	 * Don't use a trailing slash!
	 */
	'guest' => getenv('APP_ROOT_GUEST'),

];

最后，您需要将包的服务提供者添加到您的 app.providers 数组中

	'providers' => array(

		/** Various Illuminate service providers **/

		'Levacic\LaravelWhoopsEditorLink\LaravelWhoopsEditorLinkServiceProvider',

	),

当然，为了让这生效，您还需要在您的系统上为 subl:// 链接配置适当的协议处理器。

兼容性

此包是为Laravel 4.2编写的，在撰写本文时，Laravel 5.0 还不稳定。当它发布时，如果需要，该包也将更新以与之兼容。如果您需要它，而我又忘记了，请随时联系我！

贡献

由于此包的功能非常具体，因此实际上没有什么可以贡献的，但我猜我们可以为其他编辑器添加相同的功能——如果有人需要它或想要添加此功能，只需打开一个问题或拉取请求，我们就会修复它。

许可

该包根据 MIT 许可证 作为开源软件发布。