README

这是一个安装程序，它会下载NodeJS和NPM，并将它们安装到您的Composer依赖项中。如果您的机器上已经安装了NodeJS，则将跳过安装。

这是原始包（mouf/nodejs-installer）的更新版本。我们尽量保持原有功能不变，只进行必要的更改，以提高安装程序的可稳定性和质量。

为什么？

NodeJS正逐渐成为现代网络开发者工具链的一部分。Bower、Grunt、Gulp等工具每天都在构建应用程序中使用。对于PHP开发者来说，这意味着PHP项目需要在NodeJS或Bower / NPM包上构建依赖关系。NodeJS-installer试图通过将NodeJS作为Composer依赖项轻松安装来弥合NodeJS和PHP之间的差距。

在此包的基础上，其他包如koala-framework/composer-extra-assets可以用于自动获取Bower / NPM包、运行Gulp / Grunt任务等...

它是如何工作的？

只需在您的composer.json要求中包含此包

{
    "require": {
        "mouf/nodejs-installer": "~1.0"
    }
}

默认情况下，如果您的计算机上没有NodeJS，它将下载并安装到vendor/nodejs/nodejs。

您应该使用在vendor/bin目录中创建的脚本访问NodeJS和NPM

• vendor/bin/node（在Windows上是vendor/bin/node.bat）
• vendor/bin/npm（在Windows上是vendor/bin/npm.bat）

选项

有一些选项可用于自定义NodeJS安装

{
    "require": {
        "mouf/nodejs-installer": "~1.0"
    },
    "extra": {
        "mouf": {
            "nodejs": {
                "version": "~0.12",
                "targetDir": "vendor/nodejs/nodejs",
                "forceLocal": false
            }
        }
    }
}

可用选项

• version：这是要下载和安装的NodeJS版本号。您可以使用通常的Composer格式指定版本约束（例如 "~0.12" 或 ">0.11"）。
  默认值：默认安装最新的稳定版NodeJS。
• targetDir：NodeJS将被安装的目标目录。相对于项目根目录。
  此选项仅适用于根包。
  默认值：vendor/nodejs/nodejs
• forceLocal（布尔值）：如果设置为true，即使您的计算机上已安装NodeJS，NodeJS也始终将下载并本地安装。
  此选项仅适用于根包。
  默认值：false
• includeBinInPath（布尔值）：在运行Composer插件后，可以选择将vendor/bin目录添加到PATH。如果您在其他插件中依赖于全局计算机上的“node”或“npm”，这将非常有用。使用此选项，这些其他插件将自动找到已下载的node/npm版本。请注意，PATH仅设置在Composer脚本的持续时间。此选项不会影响您的全局环境。
  此选项仅适用于根包。
  默认值：false

自定义脚本

安装程序监听以下Composer脚本以启动

{
    "post-install-cmd": {
        // ...
    },
    "post-update-cmd": {
        // ...
    }
}

如果您需要手动启动安装程序，可以运行以下命令

$ composer run-script download-nodejs