Manual do PHP
Anterior | Capítulo 6. Instalação em sistemas Windows | Próxima

# Instalação de extensões no Windows

Depois de instalar o PHP e um servidor web no Windows, você provavelmente desejará instalar algumas extensões para ter funcionalidades extras. Você pode escolher quais extensões você quer que o PHP carregue quando é iniciado modificando o arquivo `php.ini`. Você também pode carregar um módulo dinamicamente no seu script usando dl().

Os DLLs para extensões do PHP são prefixadas com `php_`.

Many extensions are built into the Windows version of PHP. This means additional DLL files, and the extension directive, are not used to load these extensions. The Windows PHP Extensions table lists extensions that require, or used to require, additional PHP DLL files. Here's a list of built in extensions:

No PHP 4 (atualizado PHP 4.3.11): BCMath, Caledar, COM, Ctype, FTP, MySQL, ODBC, Overload, PCRE, Session, Tokenizer, WDDX, XML e Zlib

No PHP 5 (atualizado PHP 5.0.4), as seguintes mudanças existem. Embutido: DOM, LibXML, Iconv, SimpleXML, SPL e SQLite. E os seguintes não são mais embutidos: MySQL e Overload.

A localização padrão que o PHP procura por extensões é `C:\php4\extensions` no PHP 4 e `C:\php5` no PHP 5. Para mudar esta configuração para refletir sua instalação do PHP, edite o arquivo `php.ini`:

- Você precisará mudar a configuração extension_dirpara apontar o diretório onde suas extensões estão guardadas, ou onde você colocou os arquivos `php_*.dll`. Por exemplo:

      extension_dir = C:\php\extensions

- Habilite as extensão(ões) no arquivo `php.ini` que você quiser descomentando as linhas `extension=php_*.dll`. Isso é feito removendo o ; na antes da linha com a extensão que você quer carregar.

  Exemplo 6-8. Habilitar a extensão Bzip2 para o PHP-Windows
      // Mude a seguinte linha de ...
      ;extension=php_bz2.dll

      // ... para
      extension=php_bz2.dll

- Algumas das extensões precisam de DLLs extras para funcionarem. Algumas delas podem ser encontradas no pacote da distribuição, na pasta `C:\php\dlls\` no PHP 4 ou na pasta principal no PHP 5, mas algumas, por exemplo o Oracle (`php_oci8.dll`) requerem DLLs que não estão agregadas ao pacote da distribuição. Se você estiver instalando o PHP 4, copie as DLLs agregadas da pasta `C:\php\dlls` para a pasta principal `C:\php`. Não se esqueça de incluir `C:\php` na variável de ambiente `PATH` (esse processo é explicado em outra página, nesse FAQ).

- Algumas destas dlls não sao embutidas com a distribuição do PHP. Veja a documentação de cada extensão para maiores detalhes. Também leia o manual na sessão entitulada Instalação de extensões PECL para detalhes sobre PECL. Um crestente número de extensões para o PHP são encontradas no PECL, e estas extensões precisam de um download separado.

> Nota: Se você estiver executando a versão de módulo do servidor do PHP lembre de reiniciar o servidor web para que as mudanças no arquivo `php.ini` sejam efetivadas.

A tabela a seguir descreve algumas das extensões disponíveis e requer dlls adicionais.

Tabela 6-1. Extensões do PHP

Extensão | Descrição | Notas
--- | --- | ---
php_bz2.dll | Funções de Compressão de bzip2 | Nenhuma
php_calendar.dll | Funções de Conversão de Calendar | Integrado desde o PHP 4.0.3
php_cpdf.dll | Funções de ClibPDF | Nenhuma
php_crack.dll | Funções de Crack | Nenhuma
php_ctype.dll | Família de Funções ctype | Integrado desde o PHP 4.3.0
php_curl.dll | Biblioteca de Funções de Cliente URL - CURL | Requer: `libeay32.dll`, `ssleay32.dll` (agregado)
php_cybercash.dll | Funções de Pagamento Cybercash | PHP <= 4.2.0
php_db.dll | Funções DBM | Depreciado. Ao invés, use DBA (`php_dba.dll`)
php_dba.dll | Camada de Funções de Abstração de Banco de Dados DBA | Nenhuma
php_dbase.dll | Funções de dBase | Nenhuma
php_dbx.dll | Funções dbx |
php_domxml.dll | Funções DOM XML | PHP <= 4.2.0 requer: `libxml2.dll` (agregado) PHP >= 4.3.0 requer: `iconv.dll` (agregado)
php_dotnet.dll | Funções .NET | PHP <= 4.1.1
php_exif.dll | Funções EXIF | php_mbstring.dll. e, `php_exif.dll` devem ser carregados `depois` de `php_mbstring.dll` no arquivo `php.ini`.
php_fbsql.dll | Funções FrontBase | PHP <= 4.2.0
php_fdf.dll | Funções de Formato de Dados de Formulários (Forms Data Format) FDF. | Requer: `fdftk.dll` (agregado)
php_filepro.dll | Funções de filePro | Acesso apenas de Leitura
php_ftp.dll | Funções de FTP | Integrado desde o PHP 4.0.3
php_gd.dll | Funções da biblioteca de imagens GD | Removido no PHP 4.3.2. Note também que funções truecolor functions não estão disponíveis no GD1, ao invés, use `php_gd2.dll`.
php_gd2.dll | Funções da biblioteca de imagens GD | GD2
php_gettext.dll | Funções de Gettext | PHP <= 4.2.0 requer `gnu_gettext.dll` (agregado), PHP >= 4.2.3 requer `libintl-1.dll`, `iconv.dll` (agregado).
php_hyperwave.dll | Funções de HyperWave | Nenhuma
php_iconv.dll | Conversão de tabela de caracteres ICONV | Requer: `iconv-1.3.dll` (agregado), PHP >=4.2.1 `iconv.dll`
php_ifx.dll | Funções de Informix | Requer: Informix libraries
php_iisfunc.dll | Funções de manuseio de IIS | Nenhuma
php_imap.dll | Funções de IMAP POP3 e NNTP | Nenhuma
php_ingres.dll | Funções de Ingres II | Requer: Ingres II libraries
php_interbase.dll | Funções de InterBase | Requer: `gds32.dll` (agregado)
php_java.dll | Funções de Java | PHP <= 4.0.6 requer: `jvm.dll` (agregado)
php_ldap.dll | Funções de LDAP | PHP <= 4.2.0 requer `libsasl.dll` (agregado), PHP >= 4.3.0 requer `libeay32.dll`, `ssleay32.dll` (agregado)
php_mbstring.dll | Funções de Multi-Byte String | Nenhuma
php_mcrypt.dll | Funções de Mcrypt Encryption | Requer: `libmcrypt.dll`
php_mhash.dll | Funções de Mhash | PHP >= 4.3.0 requer: `libmhash.dll` (agregado)
php_mime_magic.dll | Funções de Mimetype | Requer: `magic.mime` (agregado)
php_ming.dll | Funções de Ming para Flash | Nenhuma
php_msql.dll | Funções de mSQL | Requer: `msql.dll` (agregado)
php_mssql.dll | Funções de MSSQL | Requer: `ntwdblib.dll` (agregado)
php_mysql.dll | Funções de MySQL | PHP >= 5.0.0, requer `libmysql.dll` (agregado)
php_mysqli.dll | Funções de MySQLi | PHP >= 5.0.0, requer `libmysql.dll` (`libmysqli.dll` in PHP <= 5.0.2) (agregado)
php_oci8.dll | Funções de Oracle 8 | Requer: Oracle 8.1+ client libraries
php_openssl.dll | Funções de OpenSSL | Requer: `libeay32.dll` (agregado)
php_oracle.dll | Funções de Oracle | Requer: Oracle 7 client libraries
php_overload.dll | Funções de sobrecarga de Objectos | Integrado desde o PHP 4.3.0
php_pdf.dll | Funções de PDF | Nenhuma
php_pgsql.dll | Funções de PostgreSQL | Nenhuma
php_printer.dll | Funções de Impressora | Nenhuma
php_shmop.dll | Funções de Memória Compartilhada | Nenhuma
php_snmp.dll | Funções de get and walk de SNMP | Apenas no NT!
php_soap.dll | Funções de SOAP | PHP >= 5.0.0
php_sockets.dll | Funções de Socket | Nenhuma
php_sybase_ct.dll | Funções de Sybase | Requer: bibliotecas de cliente do Sybase
php_tidy.dll | Funções de Tidy | PHP >= 5.0.0
php_tokenizer.dll | Funções de Tokenizer | Integrado desde o PHP 4.3.0
php_w32api.dll | Funções de W32api | Nenhuma
php_xmlrpc.dll | Funções de XML-RPC | PHP >= 4.2.1 requer: `iconv.dll` (agregado)
php_xslt.dll | Funções de XSLT | PHP <= 4.2.0 requer `sablot.dll`, `expat.dll` (agregado). PHP >= 4.2.1 requer `sablot.dll`, `expat.dll`, `iconv.dll` (agregado).
php_yaz.dll | Funções do YAZ | Requer: `yaz.dll` (agregado)
php_zip.dll | Funções para Arquivos Zip | Acesso apenas de leitura
php_zlib.dll | Funções de compressão de ZLib | Integrado desde o PHP 4.3.0

Anterior | Principal | Próxima
Compilando a partir dos fontes | Acima | Instalação das extensões PECL