Laravel 5.4本地上传AWS S3报错解决及EC2部署SSL疑问

Hey there! Let's work through your S3 upload issue step by step, then tackle the EC2 SSL question to get everything sorted.

Fixing Laravel 5.4 S3 Upload Errors #

First, let's rule out the most common causes for upload failures:

1. Verify Dependencies & Filesystem Configuration #

• Install the correct AWS SDK version: Laravel 5.4 requires an older version of the S3 flysystem adapter. Run this command to make sure you have it:

  composer require league/flysystem-aws-s3-v3 ~1.0
  

• Check your config/filesystems.php S3 disk setup: Ensure your S3 disk is configured with valid credentials and details:

  'disks' => [
      // ... other disks
      's3' => [
          'driver' => 's3',
          'key' => env('AWS_ACCESS_KEY_ID'),
          'secret' => env('AWS_SECRET_ACCESS_KEY'),
          'region' => env('AWS_DEFAULT_REGION'),
          'bucket' => env('AWS_BUCKET'),
          'url' => env('AWS_URL'), // Optional: For CloudFront or custom domains
      ],
  ],
  

• Validate your .env variables: Double-check that AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION, and AWS_BUCKET are correctly filled (no extra spaces, typos in region names like us-east-1). Don't forget to clear config cache if you made changes:

  php artisan config:clear
  

2. Confirm IAM Permissions #

Your AWS IAM user (linked to the access key in .env) needs explicit permissions to write to your S3 bucket. At minimum, attach a policy that allows:

• s3:PutObject
• s3:GetObject (if you need to retrieve files later)
• s3:ListBucket (optional, but helpful for debugging)

You can use the managed AmazonS3FullAccess policy for testing, but for production, restrict it to your specific bucket for security.

3. Audit Your Controller Code #

Make sure you're using the Storage facade correctly in your upload controller:

use Illuminate\Support\Facades\Storage;
use Illuminate\Http\Request;

public function uploadFile(Request $request)
{
    // Validate the uploaded file first
    $request->validate([
        'file' => 'required|file|max:2048', // Adjust max size as needed
    ]);

    if ($request->hasFile('file')) {
        // Upload to S3's "uploads" directory
        $filePath = Storage::disk('s3')->put('uploads', $request->file('file'));
        
        // Or use a custom filename:
        // $filePath = Storage::disk('s3')->putFileAs('uploads', $request->file('file'), 'custom-filename.jpg');
        
        return response()->json(['path' => $filePath], 200);
    }

    return response()->json(['error' => 'No file provided'], 400);
}

4. Fix Common Specific Errors #

• "Credentials not found": Clear config cache (php artisan config:clear) and confirm .env variables are loaded correctly.
• "Bucket not found": Ensure your bucket name is exact, and the AWS_DEFAULT_REGION matches the bucket's actual region.
• "Permission denied": Double-check IAM permissions and bucket ACL settings (make sure the bucket allows writes from your IAM user).

EC2 Deployment: Do You Need SSL for S3 Uploads? #

Great question! Here's the breakdown:

• For EC2 → S3 communication: No, you don't need to install SSL on your EC2 instance specifically for S3 uploads. Laravel's S3 driver uses HTTPS by default to communicate with AWS's S3 endpoints, which are already secured with SSL. The traffic between EC2 and S3 is encrypted out of the box.
• For user → EC2 communication: If your application accepts file uploads directly from users via your EC2-hosted app, you should install SSL on EC2 (e.g., using Let's Encrypt certificates). This encrypts the data between your users and your server, which is a critical security best practice.
• Custom S3 URLs: If you're using a custom HTTP (non-HTTPS) URL for your S3 bucket, you'll run into mixed-content issues. Stick to the default HTTPS S3 endpoints or configure CloudFront with SSL for custom domains.

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