Linkable.php 1.01 KB
Newer Older
Qiang Xue committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
<?php
/**
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

namespace yii\web;

/**
 * Linkable is the interface that should be implemented by classes that typically represent locatable resources.
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @since 2.0
 */
interface Linkable
{
	/**
	 * Returns a list of links.
	 *
	 * Each link is either a URI or a [[Link]] object. The return value of this method should
	 * be an array whose keys are the relation names and values the corresponding links.
	 *
	 * If a relation name corresponds to multiple links, use an array to represent them.
	 *
	 * For example,
	 *
	 * ```php
	 * [
	 *     'self' => 'http://example.com/users/1',
	 *     'friends' => [
	 *         'http://example.com/users/2',
	 *         'http://example.com/users/3',
	 *     ],
	 *     'manager' => $managerLink, // $managerLink is a Link object
	 * ]
	 * ```
	 *
	 * @return array the links
	 */
	public function getLinks();
}