# ftp_login

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_login — 登录 FTP 服务器

### 说明

ftp_login(FTP\Connection `$ftp`, string `$username`, #[\SensitiveParameter] string `$password`): bool

登录入指定 FTP 连接。

### 参数

`ftp`

  FTP\Connection 实例。

`username`

  用户名（`USER`）。

`password`

  密码（`PASS`）。

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。 如果登录失败，PHP 会抛出一个警告。

### 更新日志

版本 | 说明
--- | ---
8.1.0 | 现在 `ftp` 参数接受 FTP\Connection 实例，之前接受 resource。

### 示例

示例 #1 ftp_login() 示例

`<?php
$ftp_server = "ftp.example.com";
$ftp_user = "foo";
$ftp_pass = "bar";
// 设置一个连接或失败时退出
$ftp = ftp_connect($ftp_server) or die("Couldn't connect to $ftp_server");
// 尝试登录
if (@ftp_login($ftp, $ftp_user, $ftp_pass)) {
echo "Connected as $ftp_user@$ftp_server\n";
} else {
echo "Couldn't connect as $ftp_user\n";
}
// 关闭连接
ftp_close($ftp);
?>`
`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open