**快速入门**
#############################
请确认您已经熟悉NOS的基本概念，如Bucket、Object、EndPoint、AccessKeyId和AccessKeySecret等。
本节您将看到如何快速的使用NOS PHP SDK,完成常用的操作，创建桶、上传文件、下载文件等。

常用类
=============================
+----------------------+---------------------------------------------------------+
|常用类                |    备注                                                 |
+======================+=========================================================+
|NOS\NosClient         |NOS 客户端类，用户通过NosClient调用服务                  |
+----------------------+---------------------------------------------------------+
|NOS\Core\NosException |NOS异常，在调用过程中去捕获这个异常，查看失败原因        |
+----------------------+---------------------------------------------------------+

基本操作
============================

创建桶
----------------------------
您可以使用以下代码新建一个桶::

	<?php
	use NOS\NosClient;
	use NOS\Core\NosException;
	
	$accessKeyId = "您的accessKeyId";
	$accessKeySecret = "您的accessKeySecret";
	$endPoint = "建桶时选择的的区域域名";
	$bucket = "使用的桶名，注意命名规则";
	
	try{
		$nosClient = new NosClient($accessKeyId,$accessKeySecret,$endPoint);
		$nosClient->createBucket($bucket);
	} catch(NosException e){
		print e->getMessage();
	}	

.. attention::
	桶名命名规则请参见 `API 手册 桶命名规范 <../api/basicConcept.html#id4>`_

	
更多的关于bucket的操作的信息，请参见 `NOS-PHP-SDK Bucket管理 <./bucketoperation.html>`_

上传文件
--------------------------------
对象（Object）是NOS中最基本的数据单元，您可以把它简单的理解为文件，以下代码可以实现简单的对象上传::

	<?php
	use NOS\NosClient;
	use NOS\Core\NosException;
	
	$accessKeyId = "您的accessKeyId";
	$accessKeySecret = "您的accessKeySecret";
	$endPoint = "建桶时选择的的区域域名";
	$bucket = "使用的桶名，注意命名规则";
	$object = "使用的对象名，注意命名规则";
	$content = "Hello NOS!";	
	try{
		$nosClient = new NosClient($accessKeyId,$accessKeySecret,$endPoint);
		$nosClient->putObject($bucket,$object,$content);
	} catch(NosException e){
		print e->getMessage();
	}

.. attention::

	对象命名规则请参见 `API 手册 对象 <../api/basicConcept.html#id2>`_

更多的上传文件信息，请参见 `NOS-PHP-SDK 上传文件 <./uploadobject.html>`_

下载文件
------------------------------
上传对象成功之后，您可以读取它的内容，以下代码可以实现文件的下载::

	<?php
	use NOS\NosClient;
	use NOS\Core\NosException;
	
	$accessKeyId = "您的accessKeyId";
	$accessKeySecret = "您的accessKeySecret";
	$endPoint = "建桶时选择的的区域域名";
	$bucket = "使用的桶名，注意命名规则";
	$object = "使用的对象名，注意命名规则";

	try{
		$nosClient = new NosClient($accessKeyId,$accessKeySecret,$endPoint);
		$content = $nosClient->getObject($bucket,$object);
		print("object content: " . $content);
	} catch(NosException e){
		print e->getMessage();
	}


更多的下载文件信息，请参见 `NOS-PHP-SDK 下载文件 <./downloadobject.html>`_

列举文件
------------------------------
当上传文件成功之后，可以查看桶中包含的文件列表，以下代码展示如何列举桶内的文件::

	<?php
	use NOS\NosClient;
	use NOS\Core\NosException;
	
	$accessKeyId = "您的accessKeyId";
	$accessKeySecret = "您的accessKeySecret";
	$endPoint = "建桶时选择的的区域域名";
	$bucket = "使用的桶名，注意命名规则";

	try{
		$nosClient = new NosClient($accessKeyId,$accessKeySecret,$endPoint);
		$listObjectInfo = $nosClient->listObjects($bucket);
    		if (!empty($objectList)) {
        		foreach ($objectList as $objectInfo) {
        			print($objectInfo->getKey() . "\t" . $objectInfo->getSize() . "\t" . $objectInfo->getLastModified() . "\n");
        		}
    		}
	} catch(NosException e){
		print e->getMessage();
	}

.. note::

	上面的代码默认列举100个object

更多的管理文件信息，请参见 `NOS-PHP-SDK 文件管理 <./managerobject.html>`_

删除文件
------------------------------
文件上传成功后，可以指定删除桶中的文件，以下代码实现桶中文件的删除::

	<?php
	use NOS\NosClient;
	use NOS\Core\NosException;
	
	$accessKeyId = "您的accessKeyId";
	$accessKeySecret = "您的accessKeySecret";
	$endPoint = "建桶时选择的的区域域名";
	$bucket = "使用的桶名，注意命名规则";
	$object = "使用的对象名，注意命名规则";

	try{
		$nosClient = new NosClient($accessKeyId,$accessKeySecret,$endPoint);
		$content = $nosClient->deleteObject($bucket,$object);
	} catch(NosException e){
		print e->getMessage();
	}


返回结果处理
------------------------------
NosClient中的接口对应返回数据分为两类:

- Put，Delete类接口返回null，如果没有NosException，即可认为操作成功
- Get，List类接口返回对应的数据，如果没有NosException，即可认为操作成功

例如::

    <?php
    $bucketListInfo = $nosClient->listBuckets();
    $bucketList = $bucketListInfo->getBucketList();
    foreach($bucketList as $bucket) {
        print($bucket->getLocation() . "\t" . $bucket->getName() . "\t" . $bucket->getCreatedate() . "\n");
    }

上面代码中的$bucketListInfo的数据类型是 NOS\\Model\\BucketListInfo