Instalando PHP 7.3 - Windows

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.

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 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
Apache 2.4 (x86 ou x64): Clique Aqui
mod_Fcgi (x86 ou x64: Clique Aqui
IonCube Loader for Windows VC15 (x86 ou x64): Clique Aqui
Scriptcase (.zip): Clique Aqui

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

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

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

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

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.

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:

<IfModule dir_module>
DirectoryIndex index.html index.php index.phtml
</IfModule>

Configuração dos arquivos index a serem aceitos

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 <Directory "${SRVROOT}/htdocs">.

Require all granted
Options ExecCGI
</Directory>

Exemplo:

Configuração httpd fcgi

7 - Procure pela diretiva <IfModule mime_module> e adicione o conteúdo abaixo acima desta diretiva:

<Directory "/php">

AllowOverride None
Options None
Require all granted

</Directory>

Exemplo:

Configuração httpd diretório PHP

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

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 startpara iniciar o seu Apache.

Iniciando o Apache

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

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

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

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

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 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 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 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

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

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

9 - Verfique as alterações realizadas através do arquivo info.php. Você precisa criar este arquivo e colocar no diretório C:\Apache24\htdocscom 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.

Verificar PHP

NOTA: Para mais informações sobre a função phpinfo(), verifique a documentação 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 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

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

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

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:

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

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

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

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

Tela de acesso ao 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.

Tela de escolha do tipo de instalação

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 , corrija a permissão deste diretório.

Tela de exibição dos diretórios do sistema

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

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

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.