跳到主要内容

如何设置 Composer

Bluehost 提供以下关于 Composer 的信息,作为礼貌提示。请注意,我们的支持团队无法为此提供进一步协助。如果您需要帮助或有疑问,请查阅 Composer 教程指南或在线论坛。


  • 什么是 Composer?
  • 如何设置 Composer
  1. 启用您的 SSH 访问
  2. 运行您的应用程序所需的 PHP 版本
  3. (可选)运行应用程序所需的其他 INI 设置
  4. 运行带有命令参数的 composer 命令
  5. 运行您想要安装的模块或扩展
  • 总结

什么是 Composer?

Composer 是一个 PHP 包管理器,用于在特定目录中安装特定模块或扩展,当服务器上的全局 PHP 安装中没有这些模块或扩展时,可能需要使用它。Composer 默认安装在我们的共享主机、VPS 和独立主机服务器上。​

作为预防措施,我们建议您在进行任何更改或运行可能直接影响您网站或应用程序的命令之前,先备份您的网站。Bluehost 提供 CodeGuard,一款专业的网站安全与备份服务,能为您的网站或应用程序提供全面保护和每日监控。

如何设置 Composer

Composer 通常由熟悉 Composer 细节且能够熟练使用 SSH 运行命令的高级用户使用。如同往常,建议您在进行任何更改或运行命令之前先备份网站。Bluehost 对这些命令可能对您的网站产生的后果不承担责任。

以下是设置 Composer 的一般指南:

  1. 启用您的 SSH 访问
    确保您的受限 shell 访问(SSH)已启用。
  • 对于共享主机,请查看文章《如何从 cPanel 启用 SSH/Shell》了解详细信息。
  • 要为 VPS/独立主机中的单个 cPanel 启用 SSH 访问,请参阅以下说明:VPS 和独立服务器 SSH 访问。
  1. 运行您的应用程序所需的 PHP 版本
    重要: 我们共享主机服务器上的最低 PHP 版本为 8.1。

示例:

/opt/cpanel/ea-php81/root/usr/bin/php  

上面示例命令行中执行的 PHP 版本是 8.1 (ea-php81)。根据您的应用程序需求,在命令行中指定 PHP 版本php 可执行文件的完整路径。推荐的方法是先 cd 到您想运行 Composer 的目录,然后执行您想使用的 php 可执行文件的完整路径。
示例:
1.

cd /home/user/public_html  
/opt/cpanel/ea-php81/root/usr/bin/php /opt/cpanel/composer/bin/composer diagnose  
  1. (可选)运行应用程序所需的其他 INI 设置
    示例:
/opt/cpanel/ea-php81/root/usr/bin/php -d memory_limit=512M  

上面示例的单条命令设置了内存限制为 512M (-d memory_limit=512M)。修改内存限制不是必须的,但如果默认的 256M 对您的应用程序不够用,可以进行调整。

  1. 运行带有命令参数的 composer 命令
    示例:
/opt/cpanel/composer/bin/composer require spatie/laravel-tags  

上面单条命令执行了“composer require”。有关 composer 命令和命令参数的列表,您可以访问在线文档:https://getcomposer.org/doc/03-cli.md。

  1. 运行您想要安装的模块或扩展
    示例:
/opt/cpanel/composer/bin/composer require spatie/laravel-tags  

上面单条命令执行了包“spatie/laravel-tags”。
请注意,这些命令是在单行中执行的。
示例(整条命令在一行中):

/opt/cpanel/ea-php81/root/usr/bin/php -d memory_limit=512M /opt/cpanel/composer/bin/composer require spatie/laravel-tags  

请记住,您在 SSH 中运行的命令、命令参数以及模块或扩展将取决于您的应用程序需求,我们的支持团队无法为您逐步指导。Bluehost 无法保证这些操作对您的网站或应用程序的影响。请您据此谨慎操作。

总结

Composer 是一个用于管理 PHP 包的工具。当服务器上的全局 PHP 安装中没有某些模块或扩展时,它会将它们安装到特定目录中。
本文概述了在共享主机、VPS 和独立主机服务器上设置 Composer(PHP 包管理器)的基本步骤和指南。强调了启用 SSH 访问、运行正确的 PHP 版本以及根据应用程序需求可能调整 INI 设置的重要性。文本还建议根据应用程序需求运行 Composer 命令,并警告这些命令可能对网站或应用程序产生的影响。强调在进行任何更改前创建备份的重要性。提醒用户,Bluehost 支持团队无法提供超出本文信息范围的 Composer 相关帮助。鼓励用户查阅 Composer 的在线文档和可用的 PHP 包资源,或参与在线论坛以获取进一步帮助。