Instalando drive PDO PHP do SQL Server no Linux

Instalando o PHP

sudo add-apt-repository ppa:ondrej/php -y
sudo apt-get update
sudo apt-get install php8.1 php8.1-dev php8.1-xml -y --allow-unauthenticated

Instalando os pré requisitos (Ubuntu 16.04 18.04 20.04 22.04)

sudo curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -

sudo curl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list > /etc/apt/sources.list.d/mssql-release.list

Instalando o ODBC do SQL Server 17

sudo apt update
sudo ACCEPT_EULA=Y apt install -y msodbcsql17
sudo apt install unixodbc-dev

Opcional: Para usar ferramentas como BCP e SQLcmd

sudo ACCEPT_EULA=Y apt-get install -y mssql-tools
echo 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
source ~/.bashrc

Instalando o driver PDO do SQL Server no PHP

sudo pecl install sqlsrv
sudo pecl install pdo_sqlsrv

Setando a configuração do driver

sudo printf "; priority=20\nextension=sqlsrv.so\n" > /etc/php/8.1/mods-available/sqlsrv.ini

sudo printf "; priority=30\nextension=pdo_sqlsrv.so\n" > /etc/php/8.1/mods-available/pdo_sqlsrv.ini

Habilitando a configuração

sudo phpenmod -v 8.1 sqlsrv pdo_sqlsrv

Se estiver usando Apache, ele deve ser reiniciado

sudo service apache2 restart

Referências

    Configurando variáveis de ambiente no Apache

    Criando no um arquivo separado com somente com as variáveis

    sudo vim /etc/apache2/conf-available/env-vars.conf

    Definindo as variáveis no arquivo

    SetEnv PASS_DB "senhaBemForte"
    SetEnv USER_DB "stringAleatoria"
    SetEnv TESTE "olha o teste"

    Habilitando a configuração

    sudo a2enconf env-vars

    Reiniciando o Apache

    sudo systemctl reload apache2

    Observações

    • Fique atento às brechas de segurança da sua aplicação. As variáveis criadas podem ser acessadas via <?=phpinfo();?> , leia esse post.
    • Se você estiver usando o PHP-FPM essas variáveis não serão enxergadas pelo PHP.

    Referências

      • https://httpd.apache.org/docs/2.4/mod/mod_env.html#setenv
      • https://docstore.mik.ua/orelly/linux/apache/ch04_06.htm
      • https://www.doppler.com/blog/configuring-php-applications-using-environment-variables
      • https://stackoverflow.com/questions/6554583/how-secure-is-storing-db-variables-with-setenv-or-in-php-ini
      • https://imasters.com.br/desenvolvimento/protegendo-seus-dados-utilizando-variaveis-de-ambiente
      • https://www.linode.com/community/questions/23444/how-do-i-access-environment-variables-set-in-conf-file-in-php-code

      Instalando o Apache2 e configurando SSL/TLS

      Instalando o Apache2

      sudo apt install apache2

      Copie os arquivos do seu projeto para o Document root do Apache: /var/www/html

      Altere as permissões de dono e grupo para o usuário do apache: 

      sudo chown -R www-data:www-data /var/www/html/

      Aplicando URL Rewriting

      Avalie se para o seu caso o rewrite é aplicável.
      Ativando o mod_rewrite

      sudo a2enmod rewrite

      Apache rodando sem SSL/TLS, edite o arquivo:

      /etc/apache2/sites-available/000-default.conf

      Dentro do bloco de código <VirtualHost *:80> </VirtualHost> , insira a configuração a seguir. O bloco deve ficar mais ou menos assim:

      <VirtualHost *:80>
        <Directory />
          Options FollowSymLinks
          AllowOverride All
        </Directory>
        <Directory /var/www>
          Options FollowSymLinks
          AllowOverride All
          Order Allow,Deny
          Allow from all
        </Directory>
      </VirtualHost>

      Apache rodando com SSL/TLS, edite o arquivo:

      /etc/apache2/sites-available/000-default-ssl.conf

      Obs: Pode haver variação no nome desse arquivo dependendo de como foi configurado o ssl/tls.

      Dentro do bloco de código <VirtualHost *:443> </VirtualHost>, insira a configuração abaixo:

      <VirtualHost *:443>
        <Directory />
          Options FollowSymLinks
          AllowOverride All
        </Directory>
        <Directory /var/www>
          Options FollowSymLinks
          AllowOverride All
          Order Allow,Deny
          Allow from all
        </Directory>
      </VirtualHost>

      Reinicie o Apache2

      sudo systemctl restart apache2

      Configurando a criptografia na comunicação  (certificado digital/HTTPS/TLS/SSL)


      Com Let’s Encrypt

      Siga os passos descritos no site da organização https://letsencrypt.org/getting-started/ .Geralmente instalar usando o https://certbot.eff.org/ dá certo.

      Observação

      Quando tentei instalar o certificado em instâncias da AWS, utilizando o DNS público da instância, exemplo ec2-52-548-54-242.compute-1.amazonaws.com, não deu certo.

      Criando o seu certificado

      Habilitando o módulo ssl

      sudo a2enmod ssl

      Reiniciando o Apache2

      sudo systemctl restart apache2

      Criando a pasta onde ficará armazenado os arquivos do certificados:

      sudo mkdir /etc/apache2/ssl

      Criando os arquivos da chave e certificado

      sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/apache2/ssl/apache.key -out /etc/apache2/ssl/apache.crt

      Durante o processo de criação, irão aparecer algumas perguntas para você responder, a mais importante é “Common Name (e.g. server FQDN or YOUR name)”, insira o nome do seu domínio ou o IP público do seu servidor WEB.

      Edite o arquivo de configuração do ssl:

      sudo vim /etc/apache2/sites-available/default-ssl.conf

      Sem os comentários, ele deve estar mais ou menos assim:

      <IfModule mod_ssl.c>
         <VirtualHost _default_:443>
         	ServerAdmin webmaster@localhost
         	DocumentRoot /var/www/html
         	ErrorLog ${APACHE_LOG_DIR}/error.log
         	CustomLog ${APACHE_LOG_DIR}/access.log combined
         	SSLEngine on
         	SSLCertificateFile  /etc/ssl/certs/ssl-cert-snakeoil.pem
         	SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key
         	<FilesMatch "\.(cgi|shtml|phtml|php)$">
                 	SSLOptions +StdEnvVars
         	</FilesMatch>
         	<Directory /usr/lib/cgi-bin>
                 	SSLOptions +StdEnvVars
         	</Directory>
         </VirtualHost>
      </IfModule>

      Edite o arquivo para ele ficar assim:

      <IfModule mod_ssl.c>
      	<VirtualHost default:443>
          	 ServerAdmin admin@example.com
          	 ServerName your_domain.com
          	 ServerAlias www.your_domain.com
          	 DocumentRoot /var/www/html
          	 ErrorLog ${APACHE_LOG_DIR}/error.log
          	 CustomLog ${APACHE_LOG_DIR}/access.log combined
          	 SSLEngine on SSLCertificateFile /etc/apache2/ssl/apache.crt
          	 SSLCertificateKeyFile /etc/apache2/ssl/apache.key
          	<FilesMatch ".(cgi|shtml|phtml|php)$">
              	SSLOptions +StdEnvVars
          	</FilesMatch>
          	<Directory /usr/lib/cgi-bin>
              	SSLOptions +StdEnvVars
          	</Directory>
      	</VirtualHost>
      </IfModule>

      Habilitando a configuração

      sudo a2ensite default-ssl.conf

      Reiniciando o Apache2

      sudo systemctl restart apache2

      Ativando redirecionamento HTTP para HTTPS

      Ativando o redirecionamento usando virtualHost

      Edite o arquivo:

      sudo vim /etc/apache2/sites-available/000-default.conf

      Adicione a linha no bloco <VirtualHost *:80> </VirtualHost> e salve.

      Redirect / https://seu-dominio-aqui.com

      Reiniciando o Apache2

      sudo systemctl restart apache2

      Trabalhando as permissões de arquivo

      Alterando a propriedade e grupo da pasta /var/www/html/ para o usuário do apache: 

      sudo chown -R www-data:www-data /var/www/html/

      Alterando as permissões de acesso da pasta.
      Obs: Esse nível de acesso pode variar conforme a sua necessidade.

      sudo chmod -R 750 /var/www/html/

      Debugando problemas

      Para acompanhar as requisições que estão chegando:

      tail -f /var/log/apache2/access.log

      Para acompanhar os erros:

      tail -f /var/log/apache2/error.log

      Referências

      • https://httpd.apache.org/download.cgi
      • https://e-tinet.com/linux/servidor-apache/
      • https://www.tecmint.com/redirect-http-to-https-on-apache/
      • https://www.digitalocean.com/community/tutorials/how-to-create-a-ssl-certificate-on-apache-for-ubuntu-14-04
      • https://book.cakephp.org/4/en/installation.html

      Criando alias no Linux

      Alias são “apelidos” que podemos dar a um comando, que geralmente é grande e queremos evitar de digitar toda vez. No meu caso é cd /var/www/html.

      Para saber quais alias estão ativos, use o comando: 

      alias

      Para criar um alias novo:

      alias <apelido>=”<comando a ser executado>”

      Exemplo usando o meu caso:

      alias @=”cd /var/www/html”  OU  alias www=”cd /var/www/html”

      Ao digitar @ ou www, e pressionar Enter no terminal, o comando cd /var/www/html será executado.

      Para excluir um aliás:

      unalias <nome do alias>

      Exemplo: 

      unalias www

      Para deixar persistente o alias no seu usuário do S.O, crie o arquivo /home/seu-user/.bash_aliases e insira no arquivo os alias criados.

      Exemplo de arquivo .bash_aliases:

      alias @="cd /var/www/html"
      alias ..="cd ../"

      Referências: 

      Configuração de resolução em um segundo monitor

      Cenário de aplicação do exemplo

      Um notebook com Linux Mint 19, usando um segundo monitor Samsung SyncMaster 933.

      Problema

      Ao conectar um segundo monitor ao notebook,  a resolução máxima suportada é 1024×768 60.00Hz.

      Solução

      1- execute o comando xrandr e procure pelo monitor auxiliar. A saída será parecida com essa:

      VGA-1 connected 1368x768+0+0 (normal left inverted right x axis y axis) 0mm x 0mm
         1024x768      60.00  
         800x600       60.32    56.25  
         848x480       60.00  

      No meu caso o monitor é o VGA-1.

      2- Criando um novo perfil para o segundo monitor:

      xrandr --newmode "1366x768_60.00"   85.25  1368 1440 1576 1784  768 771 781 798 -hsync +vsync

      Eu sei que o meu monitor suporta a resolução de 1366×768 a 60Hz, se você não souber o seu leia esse post na parte que fala de cvt.

      3- Atribuindo o novo perfil:

      xrandr --addmode VGA-1 1366x768_60.00

      4- Ativando

      xrandr --output VGA-1 --mode 1366x768_60.00

      Nesse ponto você também pode ativar pela interface gráfica do S.O. Se o monitor em questão for um que você frequentemente usa, toda vez que ligar o PC terá que executar os comandos acima. Para automatizar esse processo você pode no final do arquivo /home/SEU-USER/.profile adicionar o scritp abaixo:

      ###### CONFIGURAÇÃO DE MONITOR AUXILIAR ######
      
      # Se você usa notebook com um segundo monitor, a verificação abaixo junto com o IF do final é necessário para evitar um  erro caso o notebook seja ligado sem o monitor estar conectado.
      
      ##verifico se o monitor está conectado
      monitor=$(xrandr | grep -o 'VGA-1 connected')
      
      #crio o perfil do monitor
      xrandr --newmode "1366x768_60.00"   85.25  1368 1440 1576 1784  768 771 781 798 -hsync +vsync
      xrandr --addmode VGA-1 1366x768_60.00
      
      # condição para ativar o perfil, caso o monitor esteja conectado
      if [ "$monitor" ]; then
          xrandr --output VGA-1 --mode 1366x768_60.00
      fi

      Leia o script e substitua as ocorrências ‘VGA-1’ pelo identificador do seu monitor.

      Referências: