从PHP-FTP迁移至AWS-S3：put_object()是否支持二进制/ASCII模式？

AWS S3的put_object()函数没有直接提供类似FTP的二进制/ASCII模式选择参数——因为S3作为对象存储，本身不区分传输模式，而是通过对象元数据和内容编码处理文本与二进制文件的差异。不过可以通过以下方式模拟FTP两种模式的效果：

1. 模拟二进制模式 #

这是S3默认的处理逻辑，直接上传文件原始字节即可，无需额外处理：

$s3->put_object([
    'Bucket' => 'your-bucket',
    'Key' => 'path/to/binary-file.zip',
    'Body' => fopen('/local/path/file.zip', 'rb'), // 以二进制读取模式打开本地文件
    'ContentType' => 'application/octet-stream' // 通用二进制类型，也可根据文件类型设置对应值
]);

用二进制方式读取本地文件并上传，能保证内容与原始文件完全一致，对应FTP的二进制传输效果。

2. 模拟ASCII模式 #

FTP的ASCII模式会自动转换换行符（如Windows的CRLF转Unix的LF），S3没有自动转换机制，需要在上传前手动处理文本内容：

// 读取文本文件并转换换行符
$content = file_get_contents('/local/path/text-file.txt');
$unixLineEndingContent = str_replace("\r\n", "\n", $content);

$s3->put_object([
    'Bucket' => 'your-bucket',
    'Key' => 'path/to/text-file.txt',
    'Body' => $unixLineEndingContent,
    'ContentType' => 'text/plain' // 设置正确的文本类型
]);

如果业务需要统一文本换行格式，先在本地处理好内容再上传，就能达到FTP ASCII模式的效果。

实用建议 #

• 对于二进制文件（图片、压缩包、可执行文件等），始终用二进制读取方式打开并上传，避免内容损坏。
• 对于文本文件，根据需求决定是否转换换行符，同时务必设置正确的ContentType（如text/html、text/csv等），确保S3返回文件时能正确标识内容类型。
• 批量迁移文件时，可编写判断逻辑：根据文件扩展名自动区分文本/二进制类型，分别处理后再调用put_object上传。

内容的提问来源于stack exchange，提问作者jason