Instalando PHP 8.1 - MacOS

Esta documentação irá informar os passos necessários para a instalação do PHP 8.1 e Scriptcase de forma manual em ambientes MacOS. Realizando este tipo de instalação, você é responsável por configurar todo o seu ambiente, bem como as extensões de bancos de dados.

Abaixo estão listadas as versões do MacOS homologadas para uso do Scriptcase.

Confira a lista de versões suportadas:

Tabela de Compatibilidade

O Scriptcase é compatível com as seguintes versões do macOS.

Veja como instalar o Scriptcase com o PHP 7.0 ou 7.3 no MacOS.

• Instalando o Scriptcase com PHP 7.0 no MacOS
• Instalando o Scriptcase com PHP 7.3 no MacOS

Pré-requisitos

Se você já possui um Servidor Web com Apache e PHP 8.1 configurados, basta seguir para a configuração do SourceGardian Loader e prosseguir para a instalação manual do Scriptcase.

Para proceder com a instalação, você precisa realizar o download de alguns arquivos.

• SourceGuardian Loader para MacOS - macOS: Clique Aqui
• Scriptcase (.zip): Clique Aqui

Configure o PHP

Abaixo serão listados os comandos necessários para a instalação manual do PHP 8.1 no MacOS. Verifique corretamente a nomenclatura dos pacotes em seu MacOS terminal.

1 - Você precisa ter o Homebrew instalado para ter acesso ao PHP 8.1 e seus pacotes. Realize a instalação do Brew com o seguinte comando no MacOS terminal:

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

2 - No terminal macOS execute o comando brew update para atualizar o componente Brew.

3 - Utilize o comando brew install shivammathur/php/php@8.1 para instalar o PHP 8.1.

4 - Após o processo de instalação ser concluído, execute o comando brew info php@8.1 e siga as instruções mostradas para para prosseguir na configuração do ambiente.

5 - Você precisa configurar o Apache para que o PHP 8.1 que foi instalado no passo anterior seja utilizado como padrão em seu sistema.

Para usarmos o PHP no Apache nativo do MacOS, vamos precisar criar um certificado que autorize seu uso. Até o Monterey esse processo era opcional, mas agora é necessário ter o PHP Code Signed. Siga esse post para fazer a assinatura de código (em inglês)

5.1 - Edite o arquivo httpd.conf do Apache, encontre o bloco de linhas “Loadmodule” e adicione a linha de acordo com o seu equipamento:

Exemplo:

sudo nano /etc/apache2/httpd.conf

Chip Intel

LoadModule php_module /usr/local/opt/php@8.1/lib/httpd/modules/libphp.so

Chip da Apple

LoadModule php_module/opt/homebrew/opt/php@8.1/lib/httpd/modules/libphp.so

No final do arquivo adicione:

<FilesMatch .php$>
SetHandler application/x-httpd-php
</FilesMatch>

6 - Adicione o caminho até o módulo do PHP 8.1 instalado após a última linha LoadModule no httpd.conf.

Exemplo:

LoadModule php_module /usr/local/opt/php@8.1/lib/httpd/modules/libphp.so

`

Após realizar esta ação, salve o arquivo e reinicie o serviço de apache.

sudo apachectl restart

7 - Adicione o caminho para a instalação do PHP 8.1 no arquivo ~/.zshrccom os seguintes comandos:

sudo nano ~/.zshrc

echo 'export PATH="/opt/homebrew/opt/php@8.1/bin:$PATH"' >> ~/.zshrc echo 'exportPATH="/opt/homebrew/opt/php@8.1/sbin:$PATH"' >> ~/.zshrc

8 - Edite o arquivo ~/.bash_profile e adicione o caminho para a instalação do PHP 8.1 com o seguinte comando:

echo 'export PATH="/opt/homebrew/opt/php@8.1/bin:$PATH"'

9 - Verifique a versão do PHP executando o comando: php -v

Exemplo:

10 - Acesse o arquivo php.ini no diretório /opt/homebrew/etc/php/8.1/ e defina corretamente o valor mínimo recomendado destas diretivas do PHP listadas abaixo para que o Scriptcase funcione corretamente.

Procure pelas diretivas e atribua o valor de acordo com este exemplo:

• max_execution_time = 3600
• max_input_time = 3600
• max_input_vars = 10000
• memory_limit = 1024M
• post_max_size = 1024M
• upload_max_filesize = 1024M
• max_file_uploads = 200
• short_open_tag = On

11 - Por padrão, o PHP desabilita algumas funções que são importantes para o Scriptcase. Clique aqui para ter acesso a lista de funções necessárias para o funcionamento do Scriptcase.

• Altere a linha do item disable_functions conforme exemplo abaixo:

disable_functions =

Exemplo:

12 - Configure o TimeZone do PHP de acordo com sua região. Deve-se utilizar o valor disponível na documentação do PHP. Procure pela linha date.timezone no seu php.ini, descomente-a e edite de acordo com o TimeZone selecionado.

Exemplo:

date.timezone = America/Recife

13 - Configure a pasta em que serão armazenados os arquivos temporários. Procure pela linha ;session.save_path, descomente-a e informe o caminho até a sua pasta temporária.

Exemplo:

session.save_path = "/tmp"

14 - Salve todas as modificações realizadas e reinicie o serviço do Apache utilizando o seguinte comando no terminal:

sudo apachectl restart

15 - Verfique as alterações realizadas através do arquivo info.php. Você precisa criar este arquivo e colocar no diretório /Library/WebServer/Documents/com o seguinte conteúdo:

<?php
phpinfo();  
?>

Após isto, verifique no seu navegador a página gerada acessando a URL 127.0.0.1/info.php.

Para mais informações sobre a função phpinfo(), verifique a documentação do PHP.

Habilite o SourceGuardian Loader

Antes de dar início a instalação do Scriptcase, você precisa habilitar o loader responsável pela criptografia do Scriptcase no PHP. Siga os passos abaixo para realizar esta ação com sucesso.

1 - Acesse a pasta de Downloads e realize a extração do arquivo baixado referente ao SourceGuardian Loader no início desta documentação.

Caso ainda não tenha feito o download do SourceGuardian Loader clique aqui e baixe o arquivo de acordo com a arquitetura utilizada.

Exemplo:

cd /Users/usuario/Downloads

sudo chmod 777 loaders.macosx-arm64.zip && unzip loaders.macosx-arm64.zip

cd loaders.macosx-arm64

2 - Copie o arquivo ixed.8.1.dar e cole no diretório referente ao extension_dir do seu PHP. Usaremos o /opt/homebrew/lib/php/pecl/20210902 para este exemplo.

Exemplo:

sudo cp ixed.8.1.dar /opt/homebrew/lib/php/pecl/20210902

3 - Edite o arquivo php.ini e abaixo da última linha informe o caminho para a extensão dentro do parâmetro zend_extension:

Exemplo:

sudo bash -c 'echo "zend_extension=/opt/homebrew/lib/php/pecl/20210902/ixed.8.1.dar" > /opt/homebrew/etc/php/8.1/conf.d/sourceguardian.ini'

4 - Reinicie o serviço do Apache utilizando o seguinte comando no terminal:

sudo apachectl restart

Instalação manual do Scriptcase

Abaixo estão listados os passos necessários para se realizar uma instalação manual do Scriptcase. Para realizar os passos descritos, é necessário que você tenha um servidor web configurado em sua máquina.

1 - Realize o download do Scriptcase (.zip) diretamente da página de downloads do Scriptcase.

2 - Extraia o arquivo .zip e renomeie a pasta extraída para scriptcase.

3 - Mova a pasta scriptcase para a raiz do seu servidor web. Dependendo do seu sistema operacional e instalação, este caminho pode variar de acordo com a sua configuração. Mas, por padrão temos os seguintes diretórios:

4 - Acesse o Scriptcase em seu navegador seguindo o exemplo abaixo:

127.0.0.1/scriptcase

• Por padrão o idioma selecionado para a instalação é o Português.

5 - Verifique as extensões necessárias para o funcionamento do Scriptcase e módulos de conexão ao banco de dados que estão habilitados.

Instalação Típica

Verifique os passos abaixo para concluir a instalação manual do Scriptcase de forma típica.

NOTA: Selecionando esta instalação, o Scriptcase irá configurar o seu ambiente de forma padrão. Definindo o banco de dados de instalação e o usuário de login no Scriptcase.

Após clicar em prosseguir, você será redirecionado para a página de Login do Scriptcase.

Usuário

Neste campo é necessário informar o usuário para realizar o login no Scriptcase. Por padrão, o usuário é admin.

Senha

Neste campo é necessário informar a senha para realizar o login no Scriptcase. Por padrão, a senha é admin.

Mantenha-me conectado

Esta opção mantém o usuário logado até que o mesmo se deslogue pela interface do Scriptcase.

Esqueceu sua senha?

Ao clicar nesta opção, é possível recuperar a senha do usuário informado. Será enviado um email para o usuário em questão para que ele possa ter acesso aos passos de recuperação.

IMPORTANTE: Só será possível realizar a recuperação de senha caso você tenha configurado suas informações de SMTP. Para acessar nossa documentação que mostra como realizar esta configuração clique aqui.

Instalação Customizada

Verifique os passos abaixo para concluir a instalação manual do Scriptcase de forma customizada.

NOTA: Selecionando esta instalação, você será responsável por configurar o seu ambiente. Definindo o banco de dados de instalação e o usuário para login no Scriptcase.

1 - Verifique se os diretórios requeridos pelo Scriptcase estão com as permissões corretas. Caso algum diretório listado não possuir o ícone de verificação ativo , corrija a permissão deste diretório.

Clique em prosseguir para avançar no processo de instalação.

2 - Escolha o banco de dados em que será instalada a base de dados do Scriptcase. Por padrão, o Scriptcase recomenda que seja instalado com o banco de dados SQLite.

• Você pode alterar o banco padrão clicando no botão Alterar Banco de Dados. Ao clicar nesta opção, você precisará definir as seguintes opções:

SGBD

Nesta opção você selecionará o Driver de conexão ao seu banco de dados.

Servidor

Nesta opção você informará o servidor para conexão com o banco de dados desejado.

Usuário

Você precisa informar um usuário que tenha acesso ao banco de dados que você quer que o Scriptcase seja instalado.

Senha

Você deve informar a senha de autenticação correspondente ao usuário informado.

Banco

Você precisa informar o nome do banco de dados em que o Scriptcase será instalado.

Exemplo:

scriptcase

Clique em prosseguir para avançar no processo de instalação.

3 - Verifique se a criação das tabelas da base de dados do Scriptcase ocorreu com sucesso. As tabelas serão marcadas com o ícone de sucesso na lateral.

Clique em prosseguir para avançar no processo de instalação.

4 - Configure o usuário padrão que irá ter acesso ao Scriptcase.

Login

Nesta opção você informará o Login do usuário padrão do Scriptcase.

Senha

Nesta opção você deve informar a senha que será correspondente ao usuário informado.

Confirmação

Você precisa repetir a senha informada anteriormente para que a criação do usuário seja realizada com sucesso.

Clique em prosseguir para concluir o processo de instalação.

5 - Finalize a instalação customizada do Scriptcase em seu servidor web.

Após clicar em prosseguir, você será redirecionado para a página de Login do Scriptcase.

Usuário

Neste campo é necessário informar o usuário para realizar o login no Scriptcase. Por padrão, o usuário é admin.

Senha

Neste campo é necessário informar a senha para realizar o login no Scriptcase. Por padrão, a senha é admin.

Mantenha-me conectado

Esta opção mantém o usuário logado até que o mesmo se deslogue pela interface do Scriptcase.

Esqueceu sua senha?

Ao clicar nesta opção, é possível recuperar a senha do usuário informado. Será enviado um email para o usuário em questão para que ele possa ter acesso aos passos de recuperação.

IMPORTANTE: Só será possível realizar a recuperação de senha caso você tenha configurado suas informações de SMTP. Para acessar nossa documentação que mostra como realizar esta configuração clique aqui.

Precisa registrar o seu Scriptcase?

Você pode acessar a nossa base de conhecimento para entender todos os passos para o registro da licença do Scriptcase.