2025/12/3

【XServer】Composerをアップデート(インストール)する方法！

この記事からわかること

XServerでComposerをアップデートする方法

index

[open]

＼アプリをリリースしました／

友達や家族の誕生日をメモ！通知も届く-みんなの誕生日-

posted withアプリーチ

環境

PHP(cli)： 8.2.22
Composer：2.9.2

XServerでComposerのバージョンをアップデートする方法

XServerではComposerのバージョンがデフォルトで1系がインストールされていました。

$ composer -V
Composer version 1.10.20 2021-01-27 15:41:06
$ which composer
/usr/bin/composer

しかし2025年現在ではComposerは2系が主流になっているのでComposerのバージョンをアップデートする必要があります。しかしデフォルトでは書き込み権限のない/usr/bin/composerを参照しているのでそのままcomposer updateを実行しても書き込み権限がないためエラーになります。そのため別途Composerをインストールする必要があります。

Composerを別にインストールする

Composerを別途インストールして~/binを作成してその中に設置していきます。インストール手順は以下にコマンドを載せておきますが実際に実行する際は公式のコマンドを参照してください。(ハッシュ値があるので都度変わる可能性があるためです)

XServerにsshで接続してルートでコマンドを実行していきます。

$ ssh -l xsXXXXXXX -i ~/.ssh/xsXXXXXXX.key xsXXXXXXX.xsrv.jp -p 10022
  
// インストーラーを直下にコピー
$ php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
$ php -r "if (hash_file('sha384', 'composer-setup.php') === 'c8b085408188070d5f52bcfe4ecfbee5f727afa458b2573b8eaaf77b3419b0bf2768dc67c86944da1544f06fa544fd47') { echo 'Installer verified'.PHP_EOL; } else { echo 'Installer corrupt'.PHP_EOL; unlink('composer-setup.php'); exit(1); }"
// インストーラー実行
$ php composer-setup.php
// インストーラー削除
$ php -r "unlink('composer-setup.php');"

インストールが無事成功したら以下のように表示され直下に「composer.phar」が生成されます。

All settings correct for using Composer
Downloading...

Composer (version 2.9.2) successfully installed to: /home/xsXXXXXXX/composer.phar
Use it: php composer.phar

作成された「composer.phar」を直下にbinファイルを作成してその中にリネーム(移動)します。

$ mv ./composer.phar ~/bin/composer

移動できたらパスを通しておきます。

$ vi .bach_profile
// インサートモード
$ i 

// パスを追加
export PATH=$HOME/bin:$PATH

// 保存して終了
$ :wq

// 反映
$ source ~/.bashrc

これで再度Composerのバージョンを確認してみてください。正しくバージョンがアップデートされwhichでも場所が変更されていれば成功です。もしうまく反映されていない場合は一度sshの接続切って再度接続し直してください。

$ composer --version
Composer version 2.9.2 2025-11-19 21:57:25
PHP version 8.2.22 (/opt/php-8.2.22/bin/php)
Run the "diagnose" command to get more detailed diagnostics output.

$ which composer
~/bin/composer

ご覧いただきありがとうございました。

Web制作