Assistência aos módulos PHP

4D v16.3

PHP

Este anexo detalha a implementação dos módulos PHP em 4D. São tratados os seguintes temas:

Lista de módulos padrão PHP oferecidos automaticamente com o intérprete PHP de 4D
Lista de módulos padrão PHP não retidos por 4D
Modificações do arquivo php.ini

Nota: se deseja instalar módulos adicionais, deve utilizar um intérprete FastCGI-php externo (ver Usar outro intérprete PHP ou outro arquivo php.ini).

Módulos oferecidos automaticamente

A seguinte tabela detalha os módulos PHP oferecidos automaticamente com 4D.

Módulos genéricos

Nome	Website	Descrição
BCMath	http://php.net/bc	Calculadora binária que maneja números de qualquer tamanho e precisão representados como strings.
		Exemplo:
		`C_LONGINT($valor;$result) $valor:=4 $ok:=PHP Execute("";"bcpow";$result;$valor;3)`
Calendar	http://php.net/calendar	Conjunto de funções que simplificam a conversão entre os diferentes formatos de calendários. Baseado no calendário Juliano.
		Exemplo:
		`C_LONGINT($NúmeroDeDias) $ok:=PHP Execute("";"cal_days_in_month";$NumeroDeDias;1;2;2010)`
Ctype	http://php.net/ctype	Funções que verificam se um caractere ou uma string pertencem a uma certa classe de caracteres, dependendo da configuração local atual.
[tab/]	Exemplo:
		`// Verificar que todos os caracteres da string sejam signos de pontuação C_TEXT($myString) $myString:=",.;/" $ok:=PHP Execute("";"ctype_punct";$isPunct;$myString)`
Date and Time	http://php.net/datetime	Recuperação da data e hora desde o servidor donde o script PHP se executa
		Exemplo: `//Cálculo da hora do amanhecer em Lisboa, Portugal //Latitud: 38.4 North //Longitud: 9 West //Zenith ~= 90 //Time-lag: +1 GMT C_TIME($SunriseTime) $ok:=PHP Execute("";"date_sunrise";$SunriseTime;0;1;38,41;-9;90;1)`
DOM (Document Object Model)	http://php.net/dom	Uso de documentos XML através do API DOM API de PHP 5
Exif	http://php.net/exif	Trabalha com os metadados das imagens.
Fileinfo(*)	http://php.net/fileinfo	Detecção do tipo de conteúdo e da codificação de um arquivo.
Filter	http://php.net/filter	Validar e filtrar os dados de uma fonte não segura, como as entradas dos usuários.
		Exemplo:
		`C_LONGINT($filterId) C_TEXT($result) $ok:=PHP Execute("";"filter_id";$filterId;"validate_email") $ok:=PHP Execute("";"filter_var";$result;"hop@123.com";$filterId)`
FTP (File Transfert Protocol)	http://php.net/ftp	Acesso detalhado a um servidor FTP
Hash	http://php.net/hash	Motor de resumo de mensagens (Message Digest). Permite o processamento direto ou indireto da mensagem de longitude arbitrário utilizando uma variedade de algoritmos
		Exemplo:
		`C_TEXT($md5Result) $ok:=PHP Execute("";"md5";$md5Result;"esta é minha string à que se lhe vá a fazer hash")`
GD (Graphics Draw) Library	http://php.net/gd	Manipulação de imagens
Iconv	http://php.net/iconv	Conversão de arquivos entre diferentes conjuntos de caracteres
JSON (JavaScript Object Notation)	http://php.net/json	Implementação do formato de intercâmbio de dados JSON
LDAP	http://php.net/ldap	LDAP é um protocolo de acesso aos "servidores de pastas" que armazenam a informação em forma de diagrama de árvore
LibXML	http://php.net/libxml	Biblioteca de funções e constantes XML
LibXSLT	http://php.net/xsl	Biblioteca de funções de transformação XSL
Multibyte String	http://php.net/mbstring	Conjunto de funções de manipulação de strings que permite trabalhar com as codificações multi-bytes ou converter os conjuntos de caracteres.
OpenSSL	http://php.net/openssl	Uso das funções de OpenSSL para gerar e verificar as assinaturas, codificar e decodificar os dados.
PCRE (Perl Compatible Regular Expressions)	http://php.net/pcre	Conjunto de funções que implementam as expressões racionais utilizando a mesma sintaxe e semântica que Perl 5
		Exemplo:
		`// Este exemplo remove os espaços desnecessários de uma string C_TEXT($myString) $myString:="foo o bar" PHP Execute("";"preg_replace";$myString;"/\\s\\s+/";" ";$myString) ALERT($myString) //A string contém agora 'foo o bar' sem espaços duplicados`
PDO (PHP Data Objects)	http://php.net/pdo	Interface de acesso a um banco de dados. Necessita um driver PDO específico ao banco de dados.
PDO_SQLITE	http://php.net/pdo_sqlite	Driver que implementa a interface de PHP Data Objects (PDO) para autorizar o acesso de PHP aos bancos de dados SQLite 3.
Reflection	http://php.net/reflection	API de reflexão completa que permite fazer engenharia reversa sobre as classes, as interfaces, as funções, os métodos, como também as extensões
Phar (PHP Archive)	http://php.net/phar	Permite incluir uma aplicação PHP completa em um arquivo único chamado "phar" (PHP Archive) para facilitar sua instalação e sua configuração
Session	http://php.net/session	Suporte de sessões PHP
		Exemplo:
		As sessões se utilizam nas aplicações web para conservar o contexto entre cada consulta. Quando você chama PHP Execute em 4D, o script PHP pode iniciar uma sessão e armazenar tudo o que for útil para conservar como contexto no array associado $_SESSION. Se um script PHP utiliza as sessões, deve obter o ID de sessão devolvido por PHP utilizando o comando PHP GET FULL RESPONSE e definir antes de cada chamada a PHP Execute utilizando o comando SET ENVIRONMENT VARIABLE.
		`// Método "PHP Executar com contexto" If(<>PHP_Session#"") SET ENVIRONMENT VARIABLE("HTTP_COOKIE";<>PHP_Session) End if If(PHP Execute($1)) PHP GET FULL RESPONSE($0;$errorInfos;$errorValues;$headerFields;$headerValues) $idx:=Find in array($headerFields;"Set-Cookie") If($idx>0) <>PHP_Session:=$headerValues{$idx} End if End if`
SimpleXML	http://php.net/simpleXML	Ferramentas muito simples e fáceis de utilizar para converter de XML a um objeto que pode ser processado com suas propriedades e os iteradores de arrays
Sockets	http://php.net/sockets	Implementação de uma interface de baixo nivel com as funções de comunicação por socket baseados nos sockets BSD e oferece a possibilidade de funcionar também como servidor socket e cliente.
SPL (Standard PHP Library)	http://php.net/spl	Coleção de interfaces e de classes utilitárias criadas para resolver problemas padrão.
SQLite	http://php.net/sqlite	Extensão para o motor de banco de dados SQLite. Este motor pode estar embebido.
SQLite3	http://php.net/sqlite3	Suporte para os bases de dados SQLite versión 3
Tokenizer	http://php.net/tokenizer	Funções que permitem escrever suas proprias ferramentas PHP de análise ou de modificações sem ter que tratar com a especificação da linguagem ao nível lexical
XML (eXtensible Markup Language)	http://php.net/xml	Análise dos documentos XML
XMLreader	http://php.net/xmlreader	Analizador XML Pull
XMLwriter	http://php.net/xmlwriter	Geração do fluxo e dos arquivos ao formato XML
Zlib	http://php.net/zlib	Leitura e escritura de arquivos comprimidos gzip (.gz)
		Exemplo:
		WEB GET HTTP HEADER($names;$values) $pos:=Find in array($names;"Accept-Encoding") If($pos>0) Case of :(Position($values{$pos};"gzip")>0) WEB SET HTTP HEADER("Content-Encoding: gzip") PHP Execute("";"gzencode";$html;$html) :(Position($values{$pos};"deflate")>0) WEB SET HTTP HEADER("Content-Encoding: deflate") PHP Execute("";"gzdeflate";$html;$html) End case End if WEB SEND TEXT($html)
Zip	http://php.net/zip	Leitura e escritura dos arquivos comprimidos ZIP e os arquivos nele

(*) Na versão atual de 4D, estes módulos não estão disponíveis em Windows

Modules only available under Windows

Por razões estruturais, os seguintes módulos PHP só estão disponíveis na plataforma Windows.

Nome	Site web	Descrição
COM & .NET	http://php.net/com	COM (Component Object Model) é um dos métodos mais utilizados por aplicações e componentes para a comunicação em plataformas Windows. Adicionalmente, 4D suporta a exemplificação e criação de ensambles .Net sob a capa COM.
ODBC (Open DataBase Connectivity)	http://php.net/odbc	Além do suporte do ODBC padrão, o ODBC unificado de PHP lhe da acesso a várias bases de dados que tomaram emprestada a semântica dos API ODBC para implementar seus próprios API.
WDDX (Web Distributed Data eXchange)	http://php.net/wddx	Facilita os intercâmbios de dados entre aplicações web via a web, sem importar a plataforma

Módulos desatiivados

Os seguintes módulos PHP não foram implementados em 4D. A coluna direita explica a razão pela qual não foi implementado:

Nome	Website	Causa - Solução alternativa
Mimetype	http://php.net/mime-magic	Obsoleto - Utilizar Fileinfo
POSIX (Portable Operating System Interface)	http://php.net/posix	Obsoleto
Regular Expression (POSIX Extended)	http://php.net/regex	Obsoleto - Utilizar PCRE
Crack	http://php.net/crack	Licença restrita
ffmpeg	http://ffmpeg-php.sourceforge.net/	Licença restrita - Uso ffmpeg em linha de comando com LAUNCH EXTERNAL PROCESS
Image Magick	http://php.net/manual/book.imagick.php	Licença restrita - Uso GD 2
IMAP (Internet Message Access Protocol)	http://php.net/imap	Licença restrita - Uso do plug-in integrado 4D Internet Commands
PDF (Portable Document Format)	http://php.net/pdf	Licença restrita - Utilizar Haru PDF
Mysqlnd (MySQL Native Driver)	http://dev.mysql.com/downloads/connector/php-mysqlnd/	Não pertinente no ambiente 4D
Phar (PHP Archive)	http://php.net/phar	Não pertinente no ambiente 4D

Personalizar o arquivo php.ini

O arquivo "php.ini" a modificar (ver mais a frente) pode estar localizado na pasta Resources\php da aplicação 4D (arquivo por padrão) ou na pasta Resources da base (arquivo personalizado). Para mais informação sobre este tema, consulte Executar scripts PHP em 4D.

Advertência: A modificação do arquivo "php.ini" deve ser feita com precaução e requer um bom conhecimento de PHP. Para mais informação sobre a configuração dos arquivos php.ini personalizados, pode consultar os comentários que se encontram no arquivo php.ini oferecido por 4D.

Nota: Se a duração do processamento de PHP é relativamente longa (além dos 30 segundos), por padrão se devolve um erro de tipo 'timeout' em 4D e o processamento irá falhar. Neste caso, pode configurar o timeout por padrão com o propósito de dedicar mais tempo a execução PHP. Há duas formas de fazer isto:

Definindo a variável max_execution_time no arquivo "php.ini" (passe um valor em segundos). Atenção: esta configuração afeta a todas os scripts
Chamando o comando set_time_limit (nbSec) no script de execução PHP que está realizando o processo longo. Passe o tempo máximo atribuído a execução do script PHP em nbSec. Se recomenda utilizar esta configuração, já que só afeta a este script. Geralmente, por razões de segurança, é preferível conservar um valor de timeout para os scripts PHP.