mirror of
https://we.phorge.it/source/phorge.git
synced 2024-11-28 17:52:43 +01:00
ef85f49adc
Summary: This commit doesn't change license of any file. It just makes the license implicit (inherited from LICENSE file in the root directory). We are removing the headers for these reasons: - It wastes space in editors, less code is visible in editor upon opening a file. - It brings noise to diff of the first change of any file every year. - It confuses Git file copy detection when creating small files. - We don't have an explicit license header in other files (JS, CSS, images, documentation). - Using license header in every file is not obligatory: http://www.apache.org/dev/apply-license.html#new. This change is approved by Alma Chao (Lead Open Source and IP Counsel at Facebook). Test Plan: Verified that the license survived only in LICENSE file and that it didn't modify externals. Reviewers: epriestley, davidrecordon Reviewed By: epriestley CC: aran, Korvin Maniphest Tasks: T2035 Differential Revision: https://secure.phabricator.com/D3886
114 lines
2.4 KiB
PHP
114 lines
2.4 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Amazon S3 file storage engine. This engine scales well but is relatively
|
|
* high-latency since data has to be pulled off S3.
|
|
*
|
|
* @task impl Implementation
|
|
* @task internal Internals
|
|
* @group filestorage
|
|
*/
|
|
final class PhabricatorS3FileStorageEngine
|
|
extends PhabricatorFileStorageEngine {
|
|
|
|
/* -( Implementation )----------------------------------------------------- */
|
|
|
|
|
|
/**
|
|
* This engine identifies as "amazon-s3".
|
|
*
|
|
* @task impl
|
|
*/
|
|
public function getEngineIdentifier() {
|
|
return 'amazon-s3';
|
|
}
|
|
|
|
|
|
/**
|
|
* Write file data into S3.
|
|
* @task impl
|
|
*/
|
|
public function writeFile($data, array $params) {
|
|
$s3 = $this->newS3API();
|
|
|
|
$name = 'phabricator/'.Filesystem::readRandomCharacters(20);
|
|
|
|
AphrontWriteGuard::willWrite();
|
|
$s3->putObject(
|
|
$data,
|
|
$this->getBucketName(),
|
|
$name,
|
|
$acl = 'private');
|
|
|
|
return $name;
|
|
}
|
|
|
|
|
|
/**
|
|
* Load a stored blob from S3.
|
|
* @task impl
|
|
*/
|
|
public function readFile($handle) {
|
|
$result = $this->newS3API()->getObject(
|
|
$this->getBucketName(),
|
|
$handle);
|
|
return $result->body;
|
|
}
|
|
|
|
|
|
/**
|
|
* Delete a blob from S3.
|
|
* @task impl
|
|
*/
|
|
public function deleteFile($handle) {
|
|
|
|
AphrontWriteGuard::willWrite();
|
|
$this->newS3API()->deleteObject(
|
|
$this->getBucketName(),
|
|
$handle);
|
|
}
|
|
|
|
|
|
/* -( Internals )---------------------------------------------------------- */
|
|
|
|
|
|
/**
|
|
* Retrieve the S3 bucket name.
|
|
*
|
|
* @task internal
|
|
*/
|
|
private function getBucketName() {
|
|
$bucket = PhabricatorEnv::getEnvConfig('storage.s3.bucket');
|
|
if (!$bucket) {
|
|
throw new PhabricatorFileStorageConfigurationException(
|
|
"No 'storage.s3.bucket' specified!");
|
|
}
|
|
return $bucket;
|
|
}
|
|
|
|
/**
|
|
* Create a new S3 API object.
|
|
*
|
|
* @task internal
|
|
* @phutil-external-symbol class S3
|
|
*/
|
|
private function newS3API() {
|
|
$libroot = dirname(phutil_get_library_root('phabricator'));
|
|
require_once $libroot.'/externals/s3/S3.php';
|
|
|
|
$access_key = PhabricatorEnv::getEnvConfig('amazon-s3.access-key');
|
|
$secret_key = PhabricatorEnv::getEnvConfig('amazon-s3.secret-key');
|
|
|
|
if (!$access_key || !$secret_key) {
|
|
throw new PhabricatorFileStorageConfigurationException(
|
|
"Specify 'amazon-s3.access-key' and 'amazon-s3.secret-key'!");
|
|
}
|
|
|
|
$s3 = new S3($access_key, $secret_key, $use_ssl = true);
|
|
|
|
$s3->setExceptions(true);
|
|
|
|
return $s3;
|
|
}
|
|
|
|
}
|