File indexing completed on 2025-03-02 05:29:46
0001 <?php 0002 /** 0003 * Zend Framework 0004 * 0005 * LICENSE 0006 * 0007 * This source file is subject to the new BSD license that is bundled 0008 * with this package in the file LICENSE.txt. 0009 * It is also available through the world-wide-web at this URL: 0010 * http://framework.zend.com/license/new-bsd 0011 * If you did not receive a copy of the license and are unable to 0012 * obtain it through the world-wide-web, please send an email 0013 * to license@zend.com so we can send you a copy immediately. 0014 * 0015 * @category Zend 0016 * @package Zend_Service_Amazon 0017 * @subpackage Ec2 0018 * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com) 0019 * @license http://framework.zend.com/license/new-bsd New BSD License 0020 * @version $Id$ 0021 */ 0022 0023 /** 0024 * @see Zend_Service_Amazon_Ec2_Abstract 0025 */ 0026 // require_once 'Zend/Service/Amazon/Ec2/Abstract.php'; 0027 0028 /** 0029 * An Amazon EC2 interface to query which Regions your account has access to. 0030 * 0031 * @category Zend 0032 * @package Zend_Service_Amazon 0033 * @subpackage Ec2 0034 * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com) 0035 * @license http://framework.zend.com/license/new-bsd New BSD License 0036 */ 0037 class Zend_Service_Amazon_Ec2_Region extends Zend_Service_Amazon_Ec2_Abstract 0038 { 0039 0040 /** 0041 * Describes availability zones that are currently available to the account 0042 * and their states. 0043 * 0044 * @param string|array $region Name of an region. 0045 * @return array An array that contains all the return items. Keys: regionName and regionUrl. 0046 */ 0047 public function describe($region = null) 0048 { 0049 $params = array(); 0050 $params['Action'] = 'DescribeRegions'; 0051 0052 if(is_array($region) && !empty($region)) { 0053 foreach($region as $k=>$name) { 0054 $params['Region.' . ($k+1)] = $name; 0055 } 0056 } elseif($region) { 0057 $params['Region.1'] = $region; 0058 } 0059 0060 $response = $this->sendRequest($params); 0061 0062 $xpath = $response->getXPath(); 0063 $nodes = $xpath->query('//ec2:item'); 0064 0065 $return = array(); 0066 foreach ($nodes as $k => $node) { 0067 $item = array(); 0068 $item['regionName'] = $xpath->evaluate('string(ec2:regionName/text())', $node); 0069 $item['regionUrl'] = $xpath->evaluate('string(ec2:regionUrl/text())', $node); 0070 0071 $return[] = $item; 0072 unset($item); 0073 } 0074 0075 return $return; 0076 } 0077 }