Esta documentação irá informar os passos necessários para a instalação do PHP 7.3, Apache 2.4 e Scriptcase de forma manual em ambientes Windows. 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 compatíveis, bem como as bibliotecas que são necessárias para o funcionamento em um determinado sistema. Confira a lista de sistemas operacionais suportados: - Windows 7 SP1 ou Superior - Windows Vista SP2 ou Superior - Windows Server 2012 ou Superior - Windows Server 2012 R2 SP1 ou Superior Para o Windows 7, é necessário que você verifique que o sitema possui instalado os seguintes itens: - Pacotes Redistribuíveis do Visual C++ para Visual Studio (2008, 2010, 2012, 2013, 2015) x86 e x64. > NOTA: Caso você deseje acessar a documentação sobre a instalação manual do Scriptcase referente ao PHP 7.0 no Windows, acesse a documentação em nossa [base de conhecimento](https://help.scriptcase.net/portal/pt/kb/articles/instalando-php-7-0-windows-7-7-2020). ## Pré-requisitos > ATENÇÃO: Se você já possui um Servidor Web com Apache e PHP 7.3 configurados, basta seguir para a configuração do [IonCube](https://www.scriptcase.com.br/docs/pt_br/v9/manual/02-instalacao-scriptcase/05-windows_php/#id-05) e prosseguir para a instalação manual. Para proceder com a instalação, você precisa realizar o download de alguns arquivos. Verifique abaixo os arquivos que serão necessários. Arquivos necessários: - PHP 7.3 NTS (x86 ou x64): [Clique Aqui](https://windows.php.net/downloads/releases/) - Apache 2.4 (x86 ou x64): [Clique Aqui](https://www.apachelounge.com/download/) - mod\_Fcgi (x86 ou x64: [Clique Aqui](https://www.apachelounge.com/download/) - IonCube Loader for Windows VC15 (x86 ou x64): [Clique Aqui](https://www.ioncube.com/loaders.php) - Scriptcase (.zip): [Clique Aqui](https://www.scriptcase.com.br/download/) > NOTA: Antes de proceder com a instalação é recomendável não ter quaisquer outros ambientes web (como WampServer, XAMPP, Zend Server, etc.) instalados no sistema operacional. Veja abaixo as operações necessárias após o download dos itens especificados acima: 1 - Descomprima os arquivos referentes ao PHP e Apache em pastas separadas na unidade C: de seu sistema operacional. 2 - Renomeie a pasta do PHP para php. O resultado deve ser este: ![Diretório Apache e PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/php_apache_folder.png) 3 - Descomprima o arquivo referente ao mod\_Fcgi, copie o arquivo mod\_fcgid.so para a pasta `C:\Apache24\modules`. ![Mod_fcgi no diretório](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/mod_fcgi_folder.png) ## Configure o ambiente do Apache Serão listados abaixo os passos necessários para a configuração do apache de forma manual. Siga os passos corretamente para evitar problemas na instalação e inicialização do serviço. > NOTA: Como as pastas do PHP e Apache estão no mesmo nível de diretório (C:), não é preciso informar a pasta raiz nas diretivas que necessitam de que sejam informados caminhos isolados ou que apontem para um arquivo em específico. 1 - Edite o arquivo httpd.conf localizado na pasta `C:\Apache24\conf\` utilizando um editor de texto em modo de Administrador para que as modificações realizadas sejam salvas. ![Arquivo httpd.conf](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/httpd_file.png) 2 - Adicione o conteúdo abaixo após a linha `#LoadModule xml2enc_module modules/mod_xml2enc.so`: `LoadModule fcgid_module modules/mod_fcgid.so` `FcgidInitialEnv PHPRC "/php"` `FcgidInitialEnv PHP_FCGI_MAX_REQUESTS "100000"` `FcgidIOTimeout 1800` `FcgidBusyTimeout 1800` `FcgidConnectTimeout 1800` `FcgidMaxRequestLen 1073741824` `FcgidMaxRequestsPerProcess 10000` `FcgidOutputBufferSize 4000` `FcgidProcessLifeTime 3600` `Timeout 1024` `KeepAlive On` `KeepAliveTimeout 50` `MaxKeepAliveRequests 500` `AddHandler fcgid-script .php` `FcgidWrapper "/php/php-cgi.exe" .php` Exemplo: ![Configuração httpd php fcgi](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/fcgimod_httpd.png) > ATENÇÃO: Esta configuração só funcionará se você tiver copiado o arquivo mod\_fcgid.so para a pasta `C:\Apache24\modules` como instruído [anteriormente](https://www.scriptcase.com.br/docs/pt_br/v9/manual/02-instalacao-scriptcase/05-windows_php/#id-01). 3 - Procure por `#ServerName www.example.com:80` e altere esta linha para `ServerName localhost:80`. 4 - Altere o conteúdo da diretiva `DirectoryIndex` adicionando os seguintes conteúdos na linha da diretiva: `index.php index.phtml`. Exemplo: `DirectoryIndex index.html index.php index.phtml` ![Configuração dos arquivos index a serem aceitos](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/dir_index.png) 5 - Configure a variável ${SRVROOT} com o caminho da sua pasta do Apache: Procure pela linha Define SRVROOT e edite da seguinte forma: `Define SRVROOT "/Apache24"` 6 - Adicione o comando Options ExecCGI abaixo da linha Require all granted na diretiva . `Require all granted` `Options ExecCGI` Exemplo: ![Configuração httpd fcgi](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/optionscgi_httpd.png) 7 - Procure pela diretiva  e adicione o conteúdo abaixo acima desta diretiva: `AllowOverride None` `Options None` `Require all granted` Exemplo: ![Configuração httpd diretório PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/phpdir_httpd.png) Após realizar todos estes procedimentos, salve o arquivo `httpd.conf` para prosseguir para a instalação e inicialização do Apache e configuração do PHP. ## Instale e inicie o Apache Agora que você configurou o seu apache, basta apenas que você instale e inicie o serviço do mesmo. Abaixo estão os passos que devem ser realizados para concluir com sucesso este processo. 1 - Execute o prompt de comando(CMD) com privilégios de Administrador: ![Acessando o CMD](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/cmd_admin.png) 2 - Navegue até a pasta `bin` do apache para instalar o executável httpd.exe: `cd C:\Apache24\bin\httpd.exe` 3 - Instale o Apache com o comando abaixo: `httpd.exe -k install` Aguarde pela mensagem “The ‘Apache2.4’ service is successfully installed.” para prosseguir. 4 - Inicie o serviço do Apache e verifique o funcionamento do mesmo. Utilze o comando `httpd.exe -k start`para iniciar o seu Apache. ![Iniciando o Apache](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/httpd_start.png) 5 - Conceda permissão de execução do Apache no seu Firewall: Selecione as duas opções disponíveis para conceder permissão para que o Apache funcione corretamente. ![Instalação do Apache 2.4](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/apache_install_cmd.png) 6 - Verifique o funcionamento do Apache. Para verificar que o serviço está ativo, basta apenas acessar a página de teste do Apache em seu navegador. Você pode fazer de duas formas: `127.0.0.1` ou `localhost` ![Apache ativo](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/httpd_on.png) ## Configure o PHP 7.3 Com o Apache ativo e funcional, agora você só precisará definir e configurar o arquivo .ini do PHP para que as extensões do banco de dados e bibliotecas fiquem disponíveis para uso do Scriptcase. 1 - Acesse a pasta do PHP em `C:\` e renomeie o arquivo php.ini-development para php.ini. ![Php.ini](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/ini_file.png) 2 - Acesse o arquivo php.ini com um editor de texto com privilégios administrativos e procure pela diretiva `;extension_dir = "ext"`. Atribua o valor “C:\php\ext” para esta diretiva. Exemplo: `extension_dir = "C:\php\ext"` ![Extensão do PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/ext_dir_php.png) 3 - Ative as extensões listadas abaixo descomentando-as (Deve-se remover o ponto e vírgula `;` no início da linha). Extensões padrão: - `extension=bz2` - `extension=curl` - `extension=gd2` - `extension=gettext` - `extension=imap` - `extension=ldap` - `extension=fileinfo` - `extension=mbstring` - `extension=openssl` - `extension=exif` - `extension=xsl` - `extension=soap` Extensões de banco de dados: | Extensão | Driver habilitado no Scriptcase | | --- | --- | | `extension=mysqli` | MySQLi | | `extension=odbc` | DB2 ODBC GENERIC, DB2 ODBC GENERIC 6, Generic ODBC, MS Access ODBC, MS SQL Server ODBC, Oracle ODBC, Progress | | `extension=pdo_mysql` | MySQL PDO | | `extension=pdo_odbc` | DB2 PDO ODBC, Progress PDO ODBC, Sybase PDO ODBC | | `extension=pdo_pgsql` | PostgreSQL PDO | | `extension=pdo_sqlite` | SQLite PDO | | `extension=pgsql` | PostgreSQL 6.3 ou abaixo, PostgreSQL 6.4 ou acima, PostgreSQL 7 ou Acima | > NOTA: Algumas extensões de banco de dados irão depender de Drivers de terceiros para que sejam habilitadas. Clique [aqui](https://www.scriptcase.com.br/docs/pt_br/v9/manual/05-conexoes-scriptcase/01-visao-geral-db) para acessar as instruções de configuração do seu banco de dados desejado. 4 - 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` > IMPORTANTE: Por padrão o PHP pode desabilitar algumas funções que são importantes para o funcionamento correto Scriptcase. Procure pela diretiva disable\_functions e verifique se ela está conforme exemplo: `disable_functions=`. Clique [aqui](https://help.scriptcase.net/portal/pt/kb/articles/funcoes-php-necessarias-para-o-scriptcase) para ter acesso a lista destas funções. 5 - Configure o TimeZone do PHP de acordo com sua região. Deve-se utilizar o valor disponível na [documentação](https://php.net/manual/pt_BR/timezones.php) do PHP. Procure pela linha date.timezone descomente-a e edite de acordo com o TimeZone selecionado: Exemplo: `date.timezone = America/Recife` ![TimeZone do PHP](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/timzone_php.png) 6 - 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 = "C:\Windows\Temp"` ![Pasta de arquivos de sessão](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/session_php.png) 7 - Salve todas as alterações realizadas no arquivo `php.ini`. 8 - Reinicie o serviço do Apache utilizando no prompt de comando (CMD) com privilégios de Administrador o seguinte comando: `C:\Apache24\bin\httpd.exe -k restart` ![Reiniciando Apache](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/restart_httpd.png) 9 - Verfique as alterações realizadas através do arquivo info.php. Você precisa criar este arquivo e colocar no diretório `C:\Apache24\htdocs`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/windows/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 IonCube 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 - Realize a extração do arquivo baixado referente ao IonCube Loader no [início](https://www.scriptcase.com.br/docs/pt_br/v9/manual/02-instalacao-scriptcase/05-windows_php/#id-01) desta documentação. 2 - Copie o arquivo ioncube\_loader\_win\_7.3.dll e cole no diretório de extensões do PHP `C:\php\ext`. ![Colando arquivo IonCube](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/ion_file.png) 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: `zend_extension = "C:\php\ext\ioncube_loader_win_7.3.dll"` ![IonCube Extension](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/ion_ext.png) 4 - Reinicie o serviço do Apache utilizando no prompt de comando (CMD) com privilégios de Administrador o seguinte comando: `C:\Apache24\bin\httpd.exe -k restart` ![Reiniciando Apache](https://www.scriptcase.com.br/docs/pt_br/v9/assets/images/docs/install/windows/restart_httpd.png) ## 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/windows/tela_avancada_diretorios_win.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** --- *Conteúdo truncado na migração (limite do Chatwoot: 20.000 caracteres).*