環境

Ubuntu 20.04.1 LTS (Focal Fossa)
PHP 7.4.10

Microsoft のドキュメント

インストールの流れ

先にODBCドライバをインストールした後、PHP側のpeclでドライバをインストールする。
ODBCドライバがない状態では、peclでのインストール時にビルドに失敗する。

ODBCドライバのインストール

マニュアルから

sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install msodbcsql17
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y apt-get install mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install unixodbc-dev

問題発生

マニュアルではoptionalになっているが、PHPのドライバをビルドするにはunixodbc-devが必要。
しかし、素直にインストールしようとすると失敗する。

エラー

以下のパッケージには満たせない依存関係があります:
 unixodbc-dev : 依存: unixodbc (= 2.3.7)
                依存: odbcinst1debian2 (= 2.3.7) しかし、インストールされようとしていません
E: 問題を解決することができません。壊れた変更禁止パッケージがあります。

apt listしてみると

$ apt list unixodbc*
一覧表示... 完了
unixodbc-dev/bionic,focal 2.3.7 amd64
unixodbc-dev/focal 2.3.6-0.1build1 i386
unixodbc/bionic,focal 2.3.7 amd64
unixodbc/focal 2.3.6-0.1build1 i386
$ apt list odbcinst1debian2
一覧表示... 完了
odbcinst1debian2/bionic 2.3.7 amd64
odbcinst1debian2/focal 2.3.6-0.1build1 i386

amd64版はfocal向けのバージョンが合っていない。

解決策

同じバージョンで指定して、同時にインストールする。

sudo apt install unixodbc-dev=2.3.6-0.1build1 libodbc1=2.3.6-0.1build1 odbcinst1debian2=2.3.6-0.1build1

失敗する方法

i386版ならバージョンが合っているのでunixodbc-dev:i386をインストール ⇒ 後に続くpecl install sqlsrvに失敗する。
unixodbc-dev=2.3.6-0.1build1をインストール ⇒ 依存関係をインストールしてくれない。

PHP用のドライバインストール

上記の方法でunixodbc-devのインストールに成功していれば、マニュアル通りに問題なくインストールできる。

sudo pecl install sqlsrv
sudo pecl install pdo_sqlsrv
sudo su
printf "; priority=20\nextension=sqlsrv.so\n" > /etc/php/7.4/mods-available/sqlsrv.ini
printf "; priority=30\nextension=pdo_sqlsrv.so\n" > /etc/php/7.4/mods-available/pdo_sqlsrv.ini
exit
sudo phpenmod -v 7.4 sqlsrv pdo_sqlsrv```