README

MvcCore 调试 Tracy 扩展，用于在选定的目录变化时自动刷新当前浏览器标签页。

**强烈建议只在开发环境中使用此包**！

安装

composer require mvccore/ext-debug-tracy-refresh

Linux

用于执行 composer.phar 和 php 脚本的用户必须拥有

• Node.JS 目录的执行权限。
  如果需要在 /etc/sudoers 中添加这些权限，可以使用： www ALL = NOPASSWD: /root/.nvm/versions/node/vXX.XX.XX/bin
• Node.JS bin 目录在 $PATH 环境变量中，或者
  该目录可以在 system.ini 配置文件中的 [debug] 部分中
  refresh.nodePath = "/root/.nvm/versions/node/vXX.XX.XX/bin"

Windows

用于执行 composer.phar 和 php 脚本的用户必须拥有

• Node.JS 目录的执行权限，但 Windows 大多数情况下不会关心这一点。
• Node.JS bin 目录在 %PATH% 环境变量中，或者
  该目录可以在 system.ini 配置文件中的 [debug] 部分中
  refresh.nodePath = "/root/.nvm/versions/node/vXX.XX.XX/bin"

工作原理

功能

• 当检测到文件更改时，页面会自动刷新。
• 您可以选择仅监控所需目录（包括所有子目录和文件）的文件更改。
• 您可以通过路径或 JS 正则表达式定义来配置排除模式以排除像
  .git、.hg、.svn、vendor、~/Var 或任何其他目录或文件
  。
• 您可以通过配置扩展来仅检测文件更改。
• 更具体的包含/排除过滤器会导致监控启动更快！
• 具有 WebSocket 连接的服务器端应用程序会自动结束自己，
  如果在过去一分钟内没有 WebSocket 连接，所以您不必担心
  在某个地方停止它。

安装

该扩展在通过 composer.phar 进行安装期间执行 npm install 命令。
如果失败，您可以在扩展根目录中手动执行，其中包含 package.json。
Npm 安装在扩展根目录中创建 ./node_modules/ 目录
并下载几个包（约 20 个）。下载了 npm 包
@mvccore/ext-debug-tracy-refresh-js，最初用 TypeScript 编写，并预先构建了
JavaScript 文件，用于 Tracy 调试面板和 Node.JS 服务器端应用程序。
当从 Tracy 调试面板开始文件系统监控时，
通过 AJAX 请求在服务器上启动了一个 Node.JS 应用程序，该应用程序具有 WebSocket
连接，可配置的地址为（默认为 $_SERVER['SERVER_NAME']），
端口（默认为 9006）。您需要确保用于通过 web 服务器执行 PHP 脚本的用户具有
执行 Node.JS 的执行权限。

配置

可以通过 system.ini 配置文件中的这些属性进行配置

...
[debug]
; there is always used server name by application request
refresh.address  = 127.0.0.1
; you need to open this port in server firewall
refresh.port     = 9006
; you need to have exeute privileges for user used 
; to execute composer.phar and PHP scripts over web server:
refresh.nodePath = "/root/.nvm/versions/node/vXX.XX.XX/bin"
...