اتصال به فضای ذخیره‌سازی ابری در برنامه‌های PHP

پروژه و کدهای مورد استفاده در ویدیوی فوق در اینجا قابل مشاهده و دسترسی هستند.

برای استفاده از Object Storage در برنامه‌های PHP، می‌توانید از پکیج aws/aws-sdk-php استفاده کنید که بایستی با دستور زیر، آن را در پروژه خود، نصب کنید:

کپی

composer require aws/aws-sdk-php

پس از آن، کافیست تا طبق مستندات ایجاد کلید، یک کلید جدید برای باکت خود بسازید. اطلاعات مربوط به ENDPOINT و نام باکت نیز در صفحه تنظیمات، در بخش دسترسی با SDK، برای شما قرار گرفته است. در نهایت نیز، بایستی اطلاعات مربوط به Object Storage خود را به متغیرهای محیطی برنامه خود، اضافه کنید؛ به عنوان مثال:

کپیLIARA_ENDPOINT=https://<Liara Bucket Endpoint>
LIARA_BUCKET_NAME=<Bucket Name>
LIARA_ACCESS_KEY=<Access Key>
LIARA_SECRET_KEY=<Secret Key>

تمامی کارها انجام شده است و می‌توانید از Object Storage در برنامه خود، استفاده کنید؛ در ادامه، مثال‌هایی از این مورد برای‌تان آورده شده است:

نمونه کد آپلود فایل

کپی<?php

namespace AppController;

class DotEnvEnvironment
{
 public function load($path): void
 {
     $lines = file($path . '/.env');
     foreach ($lines as $line) {
         [$key, $value] = explode('=', $line, 2);
         $key = trim($key);
         $value = trim($value);

         putenv(sprintf('%s=%s', $key, $value));
         $_ENV[$key] = $value;
         $_SERVER[$key] = $value;
     }
 }
}

require 'vendor/autoload.php';
use AwsS3S3Client;
use AwsExceptionAwsException;

(new DotEnvEnvironment)->load(__DIR__);

// Setting Env Variables 
$accessKey  = getenv("LIARA_ACCESS_KEY");
$secretKey  = getenv("LIARA_SECRET_KEY");
$endpoint   = getenv("LIARA_ENDPOINT");
$bucketName = getenv("LIARA_BUCKET_NAME");

// making connection using s3
$s3 = new S3Client([
  'version' => 'latest',
  'region'  => 'us-east-1',
  'endpoint' => $endpoint,
  'credentials' => [
      'key'    => $accessKey,
      'secret' => $secretKey,
  ],
]);

try {
  // name of the file:
  $fileName = 'liara-poster.png';

  // uploading file to the bucket:
  $result = $s3->putObject([
      'Bucket' => $bucketName,
      'Key'    => $fileName,
      'Body'   => file_get_contents($fileName),
      'ACL'    => 'public-read',
  ]);

  echo "File uploaded successfully.
";
} catch (AwsException $e) {
  echo $e->getMessage() . "
";
}

نمونه کد دانلود فایل

کپی<?php

namespace AppController;

class DotEnvEnvironment
{
 public function load($path): void
 {
     $lines = file($path . '/.env');
     foreach ($lines as $line) {
         [$key, $value] = explode('=', $line, 2);
         $key = trim($key);
         $value = trim($value);

         putenv(sprintf('%s=%s', $key, $value));
         $_ENV[$key] = $value;
         $_SERVER[$key] = $value;
     }
 }
}

require 'vendor/autoload.php';
use AwsS3S3Client;
use AwsExceptionAwsException;

(new DotEnvEnvironment)->load(__DIR__);

// Setting Env Variables 
$accessKey  = getenv("LIARA_ACCESS_KEY");
$secretKey  = getenv("LIARA_SECRET_KEY");
$endpoint   = getenv("LIARA_ENDPOINT");
$bucketName = getenv("LIARA_BUCKET_NAME");

// making connection using s3
$s3 = new S3Client([
  'version' => 'latest',
  'region'  => 'us-east-1',
  'endpoint' => $endpoint,
  'credentials' => [
      'key'    => $accessKey,
      'secret' => $secretKey,
  ],
]);

try {
  // نام فایل مورد نظر برای دانلود
  $fileName = 'example.txt';

  // مسیر برای ذخیره فایل در دایرکتوری downloads
  $downloadPath = __DIR__ . '/downloads/' . $fileName;

  // دانلود فایل از سبد
  $result = $s3->getObject([
      'Bucket' => $bucketName,
      'Key'    => $fileName,
      'SaveAs' => $downloadPath,
  ]);

  echo "File '$fileName' downloaded successfully.
";
} catch (AwsException $e) {
  echo $e->getMessage() . "
";
}

نمونه کد دریافت لینک موقت دانلود فایل

کپی<?php

namespace AppController;

class DotEnvEnvironment
{
 public function load($path): void
 {
     $lines = file($path . '/.env');
     foreach ($lines as $line) {
         [$key, $value] = explode('=', $line, 2);
         $key = trim($key);
         $value = trim($value);

         putenv(sprintf('%s=%s', $key, $value));
         $_ENV[$key] = $value;
         $_SERVER[$key] = $value;
     }
 }
}

require 'vendor/autoload.php';
use AwsS3S3Client;
use AwsExceptionAwsException;

(new DotEnvEnvironment)->load(__DIR__);

// Setting Env Variables 
$accessKey  = getenv("LIARA_ACCESS_KEY");
$secretKey  = getenv("LIARA_SECRET_KEY");
$endpoint   = getenv("LIARA_ENDPOINT");
$bucketName = getenv("LIARA_BUCKET_NAME");

// making connection using s3
$s3 = new S3Client([
  'version' => 'latest',
  'region'  => 'us-east-1',
  'endpoint' => $endpoint,
  'credentials' => [
      'key'    => $accessKey,
      'secret' => $secretKey,
  ],
]);

try {
  // لیست کردن فایل‌های درون سبد
  $result = $s3->listObjectsV2([
      'Bucket' => $bucketName
  ]);

  // چک کردن آیا فایلی وجود دارد یا خیر
  if (!empty($result['Contents'])) {
      foreach ($result['Contents'] as $object) {
          $objectKey = $object['Key'];
          $command = $s3->getCommand('GetObject', [
              'Bucket' => $bucketName,
              'Key' => $objectKey
          ]);

          $request = $s3->createPresignedRequest($command, '+1 hour');

          // دریافت لینک موقت
          $presignedUrl = (string)$request->getUri();
          echo "Presigned URL for '$objectKey':
$presignedUrl

";
      }
  } else {
      echo "The bucket is empty.
";
  }
} catch (AwsException $e) {
  echo $e->getMessage() . "
";
}

نمونه کد دریافت لینک موقت دانلود فایل با دامنه اختصاصی

اگر طبق مستندات اتصال دامنه، یک دامنه اختصاصی به باکت خود متصل کرده‌اید، ساده‌ترین روش برای دریافت لینک موقت (Presigned) با دامنه اختصاصی این است که لینک را با Endpoint اصلی لیارا تولید کنید و سپس مقدار Host آن را به دامنه اختصاصی تغییر دهید.

برای این کار، لینک باید به‌صورت virtual-hosted ساخته شود؛ یعنی نام باکت در ابتدای Host قرار بگیرد (مانند bucket-name.storage.c2.liara.site) و نه در مسیر لینک. کلاینت S3 در PHP به‌صورت پیش‌فرض لینک را به‌صورت virtual-hosted می‌سازد؛ بنابراین کافیست گزینه‌ی use_path_style_endpoint را در تنظیمات کلاینت برابر با true قرار ندهید. در قطعه کد زیر، $s3 و $bucketName همانند مثال قبلی تعریف شده‌اند:

کپی<?php

// $s3 and $bucketName are defined as in the previous example
$customDomain = 'example.com'; // change this to your custom domain

$command = $s3->getCommand('GetObject', [
  'Bucket' => $bucketName,
  'Key'    => 'example_filename.png', // change this to your filename
]);

$request = $s3->createPresignedRequest($command, '+1 hour');

$url = (string) $request->getUri()->withHost($customDomain);
echo $url;

فقط مقدار host را تغییر دهید و پارامترهای *-X-Amz موجود در لینک را دستکاری نکنید؛ در غیر این صورت امضای لینک نامعتبر می‌شود و دسترسی به فایل با خطا مواجه خواهد شد.

نمونه کد حذف فایل

کپی<?php

namespace AppController;

class DotEnvEnvironment
{
 public function load($path): void
 {
     $lines = file($path . '/.env');
     foreach ($lines as $line) {
         [$key, $value] = explode('=', $line, 2);
         $key = trim($key);
         $value = trim($value);

         putenv(sprintf('%s=%s', $key, $value));
         $_ENV[$key] = $value;
         $_SERVER[$key] = $value;
     }
 }
}

require 'vendor/autoload.php';
use AwsS3S3Client;
use AwsExceptionAwsException;

(new DotEnvEnvironment)->load(__DIR__);

// Setting Env Variables 
$accessKey  = getenv("LIARA_ACCESS_KEY");
$secretKey  = getenv("LIARA_SECRET_KEY");
$endpoint   = getenv("LIARA_ENDPOINT");
$bucketName = getenv("LIARA_BUCKET_NAME");

// making connection using s3
$s3 = new S3Client([
  'version' => 'latest',
  'region'  => 'us-east-1',
  'endpoint' => $endpoint,
  'credentials' => [
      'key'    => $accessKey,
      'secret' => $secretKey,
  ],
]);

try {
  // name of the file:
  $fileNameToDelete = 'example.txt';

  // deleting the file:
  $result = $s3->deleteObject([
      'Bucket' => $bucketName,
      'Key'    => $fileNameToDelete,
  ]);

  echo "File '$fileNameToDelete' deleted successfully.
";
} catch (AwsException $e) {
  echo $e->getMessage() . "
";
}

نمونه کد نمایش لیست باکت‌ها

کپی<?php
// Require the Composer autoloader.
require 'vendor/autoload.php';

use Aws\S3\S3Client;

// Instantiate an S3 client.
$client = new S3Client([
  'region' => 'us-east-1',
  'version' => '2006-03-01',
  'endpoint' => LIARA_ENDPOINT,
  'credentials' => [
      'key' => LIARA_ACCESS_KEY,
      'secret' => LIARA_SECRET_KEY
  ],
]);

$result = $client->listBuckets([/* ... */]);
$promise = $client->listBucketsAsync([/* ... */]);

print_r($result);
print_r($promise);