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 Availibity Zones 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_Availabilityzones extends Zend_Service_Amazon_Ec2_Abstract
0038 {
0039     /**
0040      * Describes availability zones that are currently available to the account
0041      * and their states.
0042      *
0043      * @param string|array $zoneName            Name of an availability zone.
0044      * @return array                            An array that contains all the return items.  Keys: zoneName and zoneState.
0045      */
0046     public function describe($zoneName = null)
0047     {
0048         $params = array();
0049         $params['Action'] = 'DescribeAvailabilityZones';
0050 
0051         if(is_array($zoneName) && !empty($zoneName)) {
0052             foreach($zoneName as $k=>$name) {
0053                 $params['ZoneName.' . ($k+1)] = $name;
0054             }
0055         } elseif($zoneName) {
0056             $params['ZoneName.1'] = $zoneName;
0057         }
0058 
0059         $response = $this->sendRequest($params);
0060 
0061         $xpath  = $response->getXPath();
0062         $nodes  = $xpath->query('//ec2:item');
0063 
0064         $return = array();
0065         foreach ($nodes as $k => $node) {
0066             $item = array();
0067             $item['zoneName']   = $xpath->evaluate('string(ec2:zoneName/text())', $node);
0068             $item['zoneState']  = $xpath->evaluate('string(ec2:zoneState/text())', $node);
0069 
0070             $return[] = $item;
0071             unset($item);
0072         }
0073 
0074         return $return;
0075     }
0076 }