Ever needed to create an FTP connection resource defaulted to a particular dir from a URI? Here's a simple function that will take a URI like ftp://username:password@subdomain.example.com/path1/path2/, and return an FTP connection resource.
<?php
function getFtpConnection($uri)
{
// Split FTP URI into:
// $match[0] = ftp://username:password@sld.domain.tld/path1/path2/
// $match[1] = ftp://
// $match[2] = username
// $match[3] = password
// $match[4] = sld.domain.tld
// $match[5] = /path1/path2/
preg_match("/ftp:\/\/(.*?):(.*?)@(.*?)(\/.*)/i", $uri, $match);
// Set up a connection
$conn = ftp_connect($match[1] . $match[4] . $match[5]);
// Login
if (ftp_login($conn, $match[2], $match[3]))
{
// Change the dir
ftp_chdir($conn, $match[5]);
// Return the resource
return $conn;
}
// Or retun null
return null;
}
?>
ftp_connect
(PHP 4, PHP 5)
ftp_connect — Abre una conexión FTP
Descripción
$host
[, int $port = 21
[, int $timeout = 90
]] )
ftp_connect() abre una conexión FTP
al host especificado.
Parámetros
-
host -
La dirección del servidor FTP. Este parámetro no debe tener barras al final y no debe estar precedido de ftp://.
-
port -
Este parámetro especifica un puerto alternativo al que conectarse. Si es omitido o es definido como cero, entonces el puerto FTP predeterminado, 21, será utilizado.
-
timeout -
Este parámetro especifica el tiempo de espera para todas las operaciones de red subsiguientes. Si se omite, el valor predeterminado es 90 segundos. El tiempo de espera puede ser cambiado y consultado en cualquier momento con las funciones ftp_set_option() y ftp_get_option().
Valores devueltos
Devuelve una secuencia FTP en caso de éxito o FALSE en caso de error.
Ejemplos
Ejemplo #1 Ejemplo de ftp_connect()
<?php
$ftp_server = "ftp.example.com";
// establecer una conexión o finalizarla
$conn_id = ftp_connect($ftp_server) or die("No se pudo conectar a $ftp_server");
?>
Historial de cambios
| Versión | Descripción |
|---|---|
| 4.2.0 |
Se añadió timeout.
|
Ver también
- ftp_close() - Cierra una conexión FTP
- ftp_ssl_connect() - Abre una conexión segura SSL-FTP
Connecting through a firewall also depends on the type. This is an example for the Secure Gateway FTP. First you have to connect to the firewall, then open a session to the destination ftp server. This looks like this:
// Connect to firewall
$conn_id = ftp_connect("firewall.yournet.com");
// Open a session to an external ftp site
$login_result = ftp_login ($conn_id, "userid@externalhost.com", "password");
// Check open
if ((!$conn_id) || (!$login_result)) {
echo "Ftp-connect failed!"; die;
} else {
echo "Connected.";
}
// turn on passive mode transfers
ftp_pasv ($conn_id, true) ;
... and go on ...
Although an FTP port is always a number, if you specify it as one like this:
<?php $ftp = ftp_connect('example.com',210); ?>
You'll get a non-intuitive error. This, however, works [note the quotes]:
<?php $ftp = ftp_connect('example.com','210'); ?>
In testing, I have been unable to establish any socket connections (including FTP connections) on shutdown. This is important if you are trying to save the FTP transfer to run after the php script has been executed (using register_shutdown_function). I am unaware of any configuration options that control this, and I have found this affects any socket connections I have tried to establish after shutdown.
The same code works fine if it is executed at runtime, rather than on shutdown. Since I found no documentation of this behavior, I felt it important to note somewhere. May also be useful if this was crosslinked to fsockopen comments as well.
