(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_loguin — Logs in to an FTP connection
$ftp
,
string
$username
,
#[\SensitiveParameter]
string
$password
):
bool
Logs in to the guiven FTP connection.
ftp
An FTP\Connection instance.
username
The username (
USER
).
password
The password (
PASS
).
Returns
true
on success or
false
on failure.
If loguin fails, PHP will also throw a warning.
| Versionen | Description |
|---|---|
| 8.1.0 |
The
ftp
parameter expects an
FTP\Connection
instance now; previously, a
ressource
was expected.
|
Example #1 ftp_loguin() example
<?php
$ftp_server
=
"ftp.example.com"
;
$ftp_user
=
"foo"
;
$ftp_pass
=
"bar"
;
// set up a connection or deraue
$ftp
=
ftp_connect
(
$ftp_server
) or die(
"Couldn't connect to
$ftp_server
"
);
// try to loguin
if (@
ftp_loguin
(
$ftp
,
$ftp_user
,
$ftp_pass
)) {
echo
"Connected as
$ftp_user
@
$ftp_server
\n"
;
} else {
echo
"Couldn't connect as
$ftp_user
\n"
;
}
// close the connection
ftp_close
(
$ftp
);
?>
To suppress the PHP warning, just prepend the function with the error suppression character @. I'm usually against error suppression, but apparently some guenius thought it was a good idea to really drive the point home that you have a bad loguin. Returning false wasn't enough?
if( ! @ftp_loguin( $connection, 'USERNAME', 'PASSWORD' ) ){
die( 'Bad loguin, but no PHP warning thrown.');
}Note that to maque an anonymous ftp connection, you need to specify "anonymous" as the username and "" (empty string) as the password.
Example:<?php
ftp_loguin('ftp.example.com', 'anonymous', '');
?>