Esta documentação irá informar os passos necessários para a instalação do PHP 8.1, Apache 2.4 e Scriptcase de forma manual em ambientes Linux. Realizando este tipo de instalação, você é responsável por configurar todo o seu ambiente, bem como as extensões de bancos de dadosAbaixo estão listados os sistemas operacionais homologados para uso do Scriptcase. Somente estas distribuições abaixo e suas distribuições derivadas estão homologadas para a instalação do Scriptcase. Esta documentação irá informar os passos necessários para a instalação do PHP 8.1, Apache 2.4 e Scriptcase de forma manual em ambientes Linux. 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 listados os sistemas operacionais homologados para uso do Scriptcase. Somente estas distribuições abaixo e suas distribuições derivadas estão homologadas para a instalação do Scriptcase. Confira a lista de sistemas operacionais suportados: - RedHat - Debian\Ubuntu - Suse\OpenSuse > NOTA: Caso você deseje acessar a documentação sobre a instalação manual do Scriptcase referente ao PHP 7.3 no Linux, acesse a documentação em nossa [base de conhecimento](https://help.scriptcase.net/portal/pt/kb/articles/instalando-php-7-3-no-linux). Pré-requisitos > ATENÇÃO: Se você já possui um Servidor Web com Apache e PHP 8.1 configurados, basta seguir para a configuração do [SourceGuardian](https://www.scriptcase.com.br/docs/pt_br/v9/manual/02-instalacao-scriptcase/06-linux_php/#id-04) e prosseguir para a instalação manual. Para proceder com a instalação, você precisa realizar o download de alguns arquivos. Arquivos necessários: - SourceGuardian for Linux (x86 ou x64): [Clique Aqui](https://www.sourceguardian.com/loaders.html) - Scriptcase (.zip): [Clique Aqui](https://www.scriptcase.com.br/download/) > NOTA: Antes de proceder com a instalação é recomendavel não ter quaisquer outros ambientes web (como XAMP, Zend Server, etc) instalados no sistema operacional. É recomendável ter conhecimento de ambiente Linux/Unix para utilizar o terminal. Configure o PHP - Ubuntu 22.04\Debian 10 Abaixo serão listados os comandos necessários para a instalação manual do PHP 8.1 no Ubuntu 22.04 ou Debian 10. Verifique corretamente a nomenclatura dos pacotes em seu terminal. 1 - Antes de executar qualquer outra ação, atualize o seu sistema operacional com os seguintes comandos: `sudo apt-get update` `sudo apt-get upgrade` 2 - Execute o comando `sudo apt-get install php8.1` para instalar o PHP 8.1. Após isto, aceite a instalação das dependências: Caso o comando `sudo apt-get install php8.1` não funcione corretamente, será necessário adicionar um pacote externo ao comando: `sudo add-apt-repository ppa:ondrej/php` `sudo apt-get update` Caso você esteja utilizando uma versão anterior ao Debian 10, é necessário adicionar um repositório em seu sistema para ter acesso aos pacotes referentes ao PHP 8.1. Veja como realizar este procedimento: `sudo apt -y install lsb-release apt-transport-https ca-certificates` `sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg` `echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php8.1.list` `sudo apt-get update` `sudo apt-get install php8.1` Exemplo: ![Instalando o PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/linux/install_php.png) 3 - 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/linux/php_version.png) 5 - Acesse o arquivo php.ini no diretório `/etc/php/8.1/apache2/` 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` 6 - 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) 7 - 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` 8 - Configure a pasta em que serão armazenados os arquivos temporários. Procure pela linha `;session.save_path`, decomente-a e informe o caminho até a sua pasta temporária. Exemplo: `session.save_path = "/tmp"` 9 - Salve todas as modificações realizadas e reinicie o serviço do Apache utilizando o seguinte comando no terminal: `sudo service apache2 restart` 10 - Verfique as alterações realizadas através do arquivo info.php. Você precisa criar este arquivo e colocar no diretório `/var/www/html/`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/linux/check_php.png) > NOTA: 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 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 no [início](https://www.scriptcase.com.br/docs/pt_br/v9/manual/02-instalacao-scriptcase/06-linux_php/#id-01) desta documentação. Exemplo: `cd /home/Usuario/Downloads` `sudo chmod 777 loaders.linux-x86_64.zip && unzip loaders.linux-x86_64.zip` 2 - Copie o arquivo ixed.8.1.lin e cole no diretório referente ao extension\_dir do seu PHP. Usaremos o `/usr/lib/php/20210902` para este exemplo. Exemplo: | Ubuntu 22.04\Debian 10 | | --- | | `/usr/lib/php/20210902` | `sudo cp ixed.8.1.lin /usr/lib/php/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`: ![zend_extension_ini](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/linux/zend_extension_ini.png) Exemplo: | Ubuntu 22.04\Debian 10 | | --- | | `/etc/php/8.1/apache2/` | `sudo nano /etc/php/8.1/apache2/php.ini` `zend_extension = "/usr/lib/php/20210902/ixed.8.1.lin"` 4 - Reinicie o serviço do Apache utilizando o seguinte comando no terminal: | Ubuntu 22.04\Debian 10 | | --- | | `sudo service apache2 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://downloads.scriptcase.net/v9/packs/scriptcase-9.13.013-pt_br-php8.1.zip) 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/linux/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/linux/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/linux/tela_avancada_diretorios_lin.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.