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:
Para o Windows 7, é necessário que você verifique que o sitema possui instalado os seguintes itens:
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.
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:
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:
3 - Descomprima o arquivo referente ao mod_Fcgi, copie o arquivo mod_fcgid.so para a pasta C:\Apache24\modules
.
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.
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:
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>
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:
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:
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.
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:
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.
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.
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
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.
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"
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
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"
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
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
phpinfo();
?>
Após isto, verifique no seu navegador a página gerada acessando a URL 127.0.0.1/info.php
.
NOTA: Para mais informações sobre a função phpinfo(), verifique a documentação do PHP.
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
.
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"
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
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
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.
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.
Neste campo é necessário informar o usuário para realizar o login no Scriptcase. Por padrão, o usuário é admin.
Neste campo é necessário informar a senha para realizar o login no Scriptcase. Por padrão, a senha é admin.
Esta opção mantém o usuário logado até que o mesmo se deslogue pela interface do Scriptcase.
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.
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.
Nesta opção você selecionará o Driver de conexão ao seu banco de dados.
Nesta opção você informará o servidor para conexão com o banco de dados desejado.
Você precisa informar um usuário que tenha acesso ao banco de dados que você quer que o Scriptcase seja instalado.
Você deve informar a senha de autenticação correspondente ao usuário informado.
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.
Nesta opção você informará o Login do usuário padrão do Scriptcase.
Nesta opção você deve informar a senha que será correspondente ao usuário informado.
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.
Neste campo é necessário informar o usuário para realizar o login no Scriptcase. Por padrão, o usuário é admin.
Neste campo é necessário informar a senha para realizar o login no Scriptcase. Por padrão, a senha é admin.
Esta opção mantém o usuário logado até que o mesmo se deslogue pela interface do Scriptcase.
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.