Como resolvo o erro fatal PHP que recebo ao implantar uma aplicação em uma plataforma PHP do Elastic Beanstalk que se conecta a um banco de dados do Microsoft SQL Server?

Breve descrição

Ao implantar uma aplicação em uma plataforma PHP do Elastic Beanstalk que se conecta a um banco de dados do Microsoft SQL Server, você pode receber o seguinte erro:

"PHP Fatal error: Uncaught Error: Call to undefined function sqlsrv_connect() in /var/app/current/DB/"

Para conectar o PHP a um banco de dados do Microsoft SQL Server, você deve primeiro instalar e configurar a biblioteca SQLSRV e sua extensão PDO. Por padrão, essa biblioteca e extensão não estão instaladas e configuradas.

Para instalar a biblioteca SQLSRV e a extensão PDO, você pode usar um arquivo de configuração .ebextensions que executa um script em suas instâncias do Amazon Elastic Compute Cloud (Amazon EC2). O script faz o seguinte:

• Instala o driver e as ferramentas corretos para o Microsoft SQL Server
• Ativa as bibliotecas e extensões PHP necessárias

Resolução

Observação: as etapas a seguir são aplicáveis aos ambientes do Elastic Beanstalk com qualquer versão da plataforma PHP.

1.    Na raiz do pacote da aplicação, crie um diretório chamado .ebextensions.

2.    Crie um arquivo de configuração .ebextensions, como o seguinte arquivo .ebextensions/pdo_sqlsrv.config:

Importante: o arquivo.ebextensions usado na resolução a seguir é aplicável somente a instâncias Amazon Linux 1 e do Amazon Linux 2 da imagem de máquina da Amazon (AMI). O arquivo .ebextensions não se aplica ao Windows ou a instâncias personalizadas Ubuntu da AMI no Elastic Beanstalk.

###################################################################################################
#### Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
####
#### Permission is hereby granted, free of charge, to any person obtaining a copy of this
#### software and associated documentation files (the "Software"), to deal in the Software
#### without restriction, including without limitation the rights to use, copy, modify,
#### merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
#### permit persons to whom the Software is furnished to do so.
###################################################################################################

###################################################################################################
#### THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
#### INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
#### PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
#### HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
#### OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
#### SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
###################################################################################################

commands:
  install_mssql:
    command: |
      #!/bin/bash
      set -x

      # 0. EXIT if pdo_sqlsrv is already installed
      if php -m | grep -q 'pdo_sqlsrv'
      then
        echo 'pdo_sqlsrv is already installed'
      else
        # 1. Install libtool-ltdl-devel
        yum -y install libtool-ltdl-devel

        # 2. Register the Microsoft Linux repository
        wget https://packages.microsoft.com/config/rhel/8/prod.repo -O /etc/yum.repos.d/msprod.repo

        # 3. Install MSSQL and tools
        ACCEPT_EULA=N yum install mssql-tools msodbcsql17 unixODBC-devel -y --disablerepo=amzn*
        # The license terms for this product can be downloaded from http://go.microsoft.com/fwlink/?LinkId=746949 and found in /usr/share/doc/mssql-tools/LICENSE.txt . By changing "ACCEPT_EULA=N" to "ACCEPT_EULA=Y", you indicate that you accept the license terms.
        echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profile
        echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
        source ~/.bashrc

        # 4. Install SQLSRV and its PDO extension, and stop pecl/pecl7 from overwriting php.ini
        cp -f "/etc/php.ini" "/tmp/php.ini.bk"
        pecl7 install sqlsrv pdo_sqlsrv || pecl install sqlsrv pdo_sqlsrv
        cp -f "/tmp/php.ini.bk" "/etc/php.ini"

        # 5. Manually add the extensions to the proper php.ini.d file and fix parameters
        sqlvar=$(php -r "echo ini_get('extension_dir');") && chmod 0755 $sqlvar/sqlsrv.so && chmod 0755 $sqlvar/pdo_sqlsrv.so
        echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/30-pdo_sqlsrv.ini
        echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/20-sqlsrv.ini
      fi

3.    Crie um pacote de origem de aplicação que inclua seu arquivo .ebextensions da etapa 2.

4.    Implante sua aplicação Elastic Beanstalk atualizada.