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. | Versão | Codinome | | --- | --- | | macOS 15.0 | “Sequoia” | | macOS 14.2 | “Sonoma” | | macOS 13.0 | “Ventura” | | macOS 12.0 | “Monterey” | | macOS 11.0 | “Big Sur” | | macOS 10.15 | “Catalina” | | macOS v10.14 | “Mojave” | | macOS v10.13 | “High Sierra” | | macOS v10.12 | “Sierra” | | OS X v10.11 | “El Capitan” | > Veja como instalar o Scriptcase com o PHP 7.0 ou 7.3 no MacOS. > > - [Instalando o Scriptcase com PHP 7.0 no MacOS](https://help.scriptcase.net/portal/pt/kb/articles/instalando-php-7-0-mac-7-7-2020) > - [Instalando o Scriptcase com PHP 7.3 no MacOS](https://help.scriptcase.net/portal/pt/kb/articles/instalando-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](https://www.scriptcase.com.br/docs/pt_br/v9/manual/02-instalacao-scriptcase/07-mac_php/#id-03) 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](https://www.sourceguardian.com/loaders.html) - Scriptcase (.zip): [Clique Aqui](https://www.scriptcase.com.br/download/) 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. ![Brew info do PHP 8.1](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/mac/brew_info.png) 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](https://www.simplified.guide/macos/apache-php-homebrew-codesign) (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: ``` SetHandler application/x-httpd-php ``` 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` ![Configuração do módulo do PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/mac/modulos_php.png)` 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 `~/.zshrc`com 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: ![Versão do PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/mac/php_version.png) 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](https://help.scriptcase.net/portal/pt/kb/articles/funcoes-php-necessarias-para-o-scriptcase) 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: ![Configuração do disable_functions do PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/linux/disbaleFunctions_php.png) 12 - Configure o TimeZone do PHP de acordo com sua região. Deve-se utilizar o valor disponível na [documentação](http://php.net/manual/pt_BR/timezones.php) 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
``` Após isto, verifique no seu navegador a página gerada acessando a URL `127.0.0.1/info.php`. ![Verificar PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/mac/check_php_mac.png) > Para mais informações sobre a função phpinfo(), verifique a [documentação](https://www.php.net/manual/pt_BR/function.phpinfo.php) 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](https://www.sourceguardian.com/loaders.html) 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](https://www.scriptcase.com.br/download/) 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: | Windows | Servidor | | --- | --- | | `C:\Apache24\htdocs\` | Apache | | `C:\inetpub\wwwroot\` | IIS | | Linux | Servidor | | --- | --- | | `/var/www/html/` | Linux Local | | `/home/$(whoami)/public_html/` | Linux em Hospedagem | | macOS | Servidor | | --- | --- | | `/Library/WebServer/Documents` | Apache | 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. ![Tela inicial da instalação](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/tela_inicial.png) 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. ![Tela com a lista de extensões ativas](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/tela_extensoes_php.png) ## 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. ![Tela de escolha do tipo de instalação](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/windows/tela_tipo_instalacao.png) Após clicar em prosseguir, você será redirecionado para a página de Login do Scriptcase. ![Tela de acesso ao Scriptcase](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/sc_screen_install.png) #### 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](https://help.scriptcase.net/portal/pt/kb/articles/configurando-a-recuperacao-de-senha-no-scriptcase). 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. ![Tela de escolha do tipo de instalação](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/windows/tela_tipo_instalacao_avancada.png) 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 ![ativo_icon](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/ativo_icon.png), corrija a permissão deste diretório. ![Tela de exibição dos diretórios do sistema](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/mac/tela_avancada_diretorios_mac.png) 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. ![Tela de escolha do banco de dados da instalação](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/tela_avancada_banco.png) - 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: ![Alteração do banco de dados padrão](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/alterar_base.png) #### 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 ![ativo_icon](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/ativo_icon.png) na lateral. ![Tela de exibição das tabelas do sistema](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/tela_avancada_tabelas.png) Clique em prosseguir para avançar no processo de instalação. 4 - Configure o usuário padrão que irá ter acesso ao Scriptcase. ![Tela de configuração do usuário](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/tela_avancada_usuario.png) #### 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. ![Tela de finlização da instalação](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/manual_sc/tela_avancada_final.png) Após clicar em prosseguir, você será redirecionado para a página de Login do Scriptcase. ![Tela de acesso ao Scriptcase](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/sc_screen_install.png) #### 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.