<?php
/*
 * Copyright 2010-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License").
 * You may not use this file except in compliance with the License.
 * A copy of the License is located at
 *
 *  http://aws.amazon.com/apache2.0
 *
 * or in the "license" file accompanying this file. This file is distributed
 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */


class S3BrowserUpload extends AmazonS3
{
	/**
	 * The <code>POST</code> operation adds an object to a specified bucket using HTML forms. POST is an alternate
	 * form of <code>PUT</code> that enables browser-based uploads as a way of putting objects in buckets.
	 * Parameters that are passed to <code>PUT</code> via HTTP headers are instead passed as form fields to
	 * <code>POST</code> in the <code>multipart/form-data</code> encoded message body. You must have
	 * <code>WRITE</code> access on a bucket to add an object to it. Amazon S3 never stores partial objects: if
	 * you receive a successful response, you can be confident the entire object was stored.
	 *
	 * @param string $bucket (Required) The name of the bucket to use.
	 * @param string|integer $expires (Optional) The point in time when the upload form field should expire. The default value is <code>+1 hour</code>.
	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>
	 * 	<li><code>acl</code> - <code>string</code> - Optional - The access control setting to apply to the uploaded file. Accepts any of the following constants: [Allowed values: <code>AmazonS3::ACL_PRIVATE</code>, <code>AmazonS3::ACL_PUBLIC</code>, <code>AmazonS3::ACL_OPEN</code>, <code>AmazonS3::ACL_AUTH_READ</code>, <code>AmazonS3::ACL_OWNER_READ</code>, <code>AmazonS3::ACL_OWNER_FULL_CONTROL</code>].</li>
	 * 	<li><code>Cache-Control</code> - <code>string</code> - Optional - The Cache-Control HTTP header value to apply to the uploaded file. To use a <code>starts-with</code> comparison instead of an <code>equals</code> comparison, prefix the value with a <code>^</code> (carat) character.</li>
	 * 	<li><code>Content-Disposition</code> - <code>string</code> - Optional - The Content-Disposition HTTP header value to apply to the uploaded file. To use a <code>starts-with</code> comparison instead of an <code>equals</code> comparison, prefix the value with a <code>^</code> (carat) character.</li>
	 * 	<li><code>Content-Encoding</code> - <code>string</code> - Optional - The Content-Encoding HTTP header value to apply to the uploaded file. To use a <code>starts-with</code> comparison instead of an <code>equals</code> comparison, prefix the value with a <code>^</code> (carat) character.</li>
	 * 	<li><code>Content-Type</code> - <code>string</code> - Optional - The Content-Type HTTP header value to apply to the uploaded file. The default value is <code>application/octet-stream</code>. To use a <code>starts-with</code> comparison instead of an <code>equals</code> comparison, prefix the value with a <code>^</code> (carat) character.</li>
	 * 	<li><code>Expires</code> - <code>string</code> - Optional - The Expires HTTP header value to apply to the uploaded file. To use a <code>starts-with</code> comparison instead of an <code>equals</code> comparison, prefix the value with a <code>^</code> (carat) character.</li>
	 * 	<li><code>key</code> - <code>string</code> - Optional - The location where the file should be uploaded to. The default value is <code>${filename}</code>.</li>
	 * 	<li><code>success_action_redirect</code> - <code>string</code> - Optional - The URI for Amazon S3 to redirect to upon successful upload.</li>
	 * 	<li><code>success_action_status</code> - <code>integer</code> - Optional - The status code for Amazon S3 to return upon successful upload.</li>
	 * 	<li><code>x-amz-server-side-encryption</code> - <code>string</code> - Optional - The server-side encryption mechanism to use. [Allowed values: <code>AES256</code>].</li>
	 * 	<li><code>x-amz-storage-class</code> - <code>string</code> - Optional - The storage setting to apply to the object. [Allowed values: <code>AmazonS3::STORAGE_STANDARD</code>, <code>AmazonS3::STORAGE_REDUCED</code>]. The default value is <code>AmazonS3::STORAGE_STANDARD</code>.</li>
	 * 	<li><code>x-amz-meta-*</code> - <code>mixed</code> - Optional - Any custom meta tag that should be set to the object.</li>
	 * </ul>
	 * @return array An array of fields that can be converted into markup.
	 * @link http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectPOST.html POST Object
	 */
	public function generate_upload_parameters($bucket, $expires = '+1 hour', $opt = null)
	{
		if (!$opt) $opt = array();

		// Policy document
		$policy = array(
			'conditions' => array(
				array('bucket' => $bucket),
			)
		);

		// Basic form
		$form = array();
		$form['form'] = array(
			'action' => $bucket . '.s3.amazonaws.com',
			'method' => 'POST',
			'enctype' => 'multipart/form-data'
		);

		// Inputs
		$form['inputs'] = array(
			'AWSAccessKeyId' => $this->key
		);

		// Expires
		if ($expires)
		{
			if (is_numeric($expires))
			{
				$expires = gmdate('j M Y, g:i a Z', (integer) $expires);
			}

			$expires = $this->util->convert_date_to_iso8601($expires);
			$policy['expiration'] = (string) $expires;
		}

		// Default values
		if (!isset($opt['key']))
		{
			$opt['key'] = '${filename}';
		}

		// Success Action Status
		if (isset($opt['success_action_status']) && !empty($opt['success_action_status']))
		{
			$form['inputs']['success_action_status'] = (string) $opt['success_action_status'];
			$policy['conditions'][] = array(
				'success_action_status' => (string) $opt['success_action_status']
			);
			unset($opt['success_action_status']);
		}

		// Other parameters
		foreach ($opt as $param_key => $param_value)
		{
			if ($param_value[0] === '^')
			{
				$form['inputs'][$param_key] = substr((string) $param_value, 1);
				$param_value = preg_replace('/\$\{(\w*)\}/', '', (string) $param_value);
				$policy['conditions'][] = array('starts-with', '$' . $param_key, (substr((string) $param_value, 1) ? substr((string) $param_value, 1) : ''));
			}
			else
			{
				$form['inputs'][$param_key] = (string) $param_value;
				$policy['conditions'][] = array(
					$param_key => (string) $param_value
				);
			}
		}

		// Add policy
		$json_policy = json_encode($policy);
		$json_policy_b64 = base64_encode($json_policy);
		$form['inputs']['policy'] = $json_policy_b64;
		$form['metadata']['json_policy'] = $json_policy;

		// Add signature
		$form['inputs']['signature'] = base64_encode(hash_hmac('sha1', $json_policy_b64, $this->secret_key, true));

		return $form;
	}


	/*%******************************************************************************************%*/
	// HELPERS

	/**
	 * Returns the protocol of the web page that this script is currently running on. This method only works
	 * correctly when run from a publicly-accessible web page.
	 */
	public static function protocol()
	{
		return (isset($_SERVER['HTTPS']) && strtolower($_SERVER['HTTPS']) === 'on') ? 'https://' : 'http://';
	}

	/**
	 * Returns the domain (and port) of the web page that this script is currently running on. This method
	 * only works correctly when run from a publicly-accessible web page.
	 */
	public static function domain()
	{
		if (isset($_SERVER['SERVER_NAME']) && isset($_SERVER['SERVER_PORT']))
		{
			return $_SERVER['SERVER_NAME'] . ((integer) $_SERVER['SERVER_PORT'] === 80 ? '' : ':' . $_SERVER['SERVER_PORT']);
		}

		return null;
	}

	/**
	 * Returns the URI of the web page that this script is currently running on. This method only works
	 * correctly when run from a publicly-accessible web page.
	 */
	public static function current_uri()
	{
		if (isset($_SERVER['REQUEST_URI']))
		{
			$uri = self::protocol();
			$uri .= self::domain();
			$uri .= $_SERVER['REQUEST_URI'];
			return $uri;
		}

		return null;
	}
}
