2021/11/20

【Mac】PHPのインストール方法！Homebrewの使い方と環境変数の通し方！

この記事からわかること

M1チップのMacにphpをインストールする方法
Homebrewの使い方
環境変数PATHを通す方法

index

[open]

MacにPHPをインストールする手順
Homebrewとは？
Homebrew(ホームブルー)のインストール方法
Warning: /opt/homebrew/bin is not in your PATHの解決法
PHPを実際にインストールする

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

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

posted withアプリーチ

Intel製CPUのMacには標準装備されていたPHPですが、M1というCPUに変更になってからはデフォルトで入らなくなってしまいました。

今回はMacにPHPをインストールする方法とそのためにインストール必須のHomebrewのインストール方法、使い方、エラーの解決法をまとめていきたいと思います。

MacにPHPをインストールする手順

Macにphpをインストールする手順は2つです。

Homebrewのインストール
phpのインストール

今回の目標はターミナルにphp -vと記入して以下のように正常にバージョンが返ってくることを目指します。

$ php -v
PHP 8.0.12 (cli) (built: Nov  5 2021 13:03:23) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.12, Copyright (c) Zend Technologies
with Zend OPcache v8.0.12, Copyright (c), by Zend Technologies

関連記事：【まとめ】コマンドプロンプトやターミナルの違い！操作方法も解説

Homebrewとは？

Homebrew(ホームブルー)とはMacOS(及びLinux)のパッケージ管理システムの1つです。phpに限らず日々更新されていくプログラミング言語などやソフトウェアのバージョン管理やインストールなどを管理しやすくしてくれるシステムになります。

まず現在時点でHomebrewがMacに入っているか確認してみます。ターミナルにバージョンを確認するコマンドbrew -vと入力してHomebrewのバージョンが返ってくればOKですが返ってこない場合はインストールする必要があります。

$ brew -v
Homebrew 3.3.4

Homebrew(ホームブルー)のインストール方法

まずはHomebrew(ホームブルー)の公式サイトにアクセスします。

Homebrew公式サイト

公式トップページに載っているコードをターミナルにそのまま打ち込むことでインストールを始めることができます。以下に記載しておきますが、このコードは時と共に変化することもあるので最新のコードを公式サイトから参照することをお勧めします。

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

コードをターミナルに打ち込みEnterキーを押すとパスワードを求められます。Macにログインする時のパスワードを入力し再度Enterキーを押します。

コードには「bash」という文字が出てきます。私がデフォルトで使っているシェルはこの時「zsh」でしたが問題なく起動しました。不安であればデフォルトシェルをbashに切り替えてお試しください。

おすすめ記事：デフォルトシェルの変更方法

Password:
==> This script will install:
/opt/homebrew/bin/brew

〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜

/opt/homebrew/Frameworks
==> The Xcode Command Line Tools will be installed.

Press RETURN to continue or any other key to abort:

コードを実行するとこの段階でストップします。日本語に訳すと「==> Xcodeコマンドラインツールがインストールされます。」「RETURNを押して続行するか、その他のキーを押して中止します。」となります。続行したいのでEnter(RETURN)を押して処理を続けます。

ここで少し処理に時間がかかるので気長に待ちます。処理が終了しターミナルのいつもの入力待ち状態(アカウント名 ~ % )になるまで待ちましょう！

==> /usr/bin/sudo /bin/mkdir -p /opt/homebrew

〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜

Warning: /opt/homebrew/bin is not in your PATH.
  Instructions on how to configure your shell for Homebrew
  can be found in the 'Next steps' section below.
==> Installation successful!

==> Homebrew has enabled anonymous aggregate formulae and cask analytics.
Read the analytics documentation (and how to opt-out) here:
  https://docs.brew.sh/Analytics
No analytics data has been sent yet (nor will any be during this install run).

==> Homebrew is run entirely by unpaid volunteers. Please consider donating:
  https://github.com/Homebrew/brew#donations

==> Next steps:
- Run these two commands in your terminal to add Homebrew to your PATH:
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/s/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"
- Run brew help to get started
- Further documentation:
    https://docs.brew.sh

Installation successful!と表示されていれば正常にインストールは完了です。しかし「Installation successful!」が出ていても上記のように「Warning: /opt/homebrew/bin is not in your PATH.」が出ている場合もう少しやらないといけないことがあります。

これはインストールは完了したものの環境変数PATHが通っていないために起きる現象です。

Warning: /opt/homebrew/bin is not in your PATHの解決法

まずは本当にエラーが起きている確認するためにバージョンを表示させ正常に動くか試してみます。「zsh: command not found: brew」が出てしまったらやはりうまくいっていないことになります。

$ brew -v
zsh: command not found: brew

解決方法は「環境変数PATHにパスを通すこと」です。

環境変数PATHとはファイル検索時に環境変数PATHに格納したアドレスも対象に検索できる変数です。

PC内全ての検索はできないのでファイルを探すときについでにココとかココにもある可能性があるよと予め伝えておくことができるのが環境変更PATHです。

設定はzshであれば.zshrc、bashであれば.bashrcに環境変数PATHを記述します。

$ vi ~/.zshrc
// viで開いた中に記述
export PATH=/opt/homebrew/bin:$PATH

// 保存して閉じる
:wq

// 現在開いているターミナルに反映
$ source ~/.zshrc

まず最初のvi ~/.zshrcで開くとターミナルがこのような画面になります。

そこに画像のようにexport PATH=/opt/homebrew/bin:$PATH(※)を記述し、カーソルはいじらなくても半角で:wqと打てば自動で保存して閉じてくれます。

※ここに記述するパスはWarning:の後に記述されていたパスです。自分のパスを確認して記述してあげてください。

環境変数PATHにちゃんと設定できたかは$PATHの中身を表示させるechoコマンドで確認できます。設定されているPATHが「:」区切りで表示されます。ここに先ほど記述したパスがあればOKです。

$ echo $PATH
/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

再度Homebrewのバージョンを確認して問題がなければ解決です。

$ brew -v
Homebrew 3.3.4

PHPを実際にインストールする

Homebrewが無事インストールできたら続いてphpをインストールしていきます。インストールはコマンド1つbrew install phpで終了です。

$ brew install php
==> Downloading https://ghcr.io/v2/homebrew/core/php/manifests/8.0.12
######################################################################## 100.0%
〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜〜
==> Summary
🍺  /opt/homebrew/Cellar/php/8.0.12: 500 files, 77.7MB

これで最新版のphpが自動でインストールされます。正常に終了しているかバージョンを確認してみましょう！

$  php -v
PHP 8.0.12 (cli) (built: Nov  5 2021 13:03:23) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.12, Copyright (c) Zend Technologies
with Zend OPcache v8.0.12, Copyright (c), by Zend Technologies