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 }