前言:
tp5中有个小功能,在文档中介绍的不多,却非常实用,在其他地方它叫读取器。tp5中它叫获取器。如果单看文档我也觉得有些云里雾里,好像懂了又好像没懂。下面我们结合实际应用场景来看看这个获取器的应用。
应用一:
当我们在数据库中保存一张图片的路径时。我们一般会选择保存相对路径,因为相对路径更加灵活。如果在后端渲染视图时,直接使用相对路径也没有问题。可是当我们应用到接口开发中,我们返回客户单需要返回完整的带域名的路径。这个时候,我们不能在每次返回的时候,都去添加上域名。这样就非常的麻烦。下面来看看获取器如何解决这个问题。
首先我交代下数据表结构:除了表中保存图片的字段url,还有一个字段from,这个from就代表是否存在自己的服务器上,如果是1,则存储的是相对路径,而from等于别的数字,则代表存储在别的服务器上,存储的是绝对路径
然后我们将需求分解
第一我们将图片url返回到客户端时//TODO
第二是将url加上域名
我们认为,给url加上域名这个操作是比较容易复现的。
所以我们讲这个操作封装到基类之中
class BaseModel extends Model
{
/**
* 拼接web域名,根据传入$data中的from判断储存状况.自动返回url
* @param $value 存储的url
* @param $data 当前url所属的整条数据
* @return string
*/
protected function splicingPrefix($value, $data)
{
//如果from的值等于1则说明是存在自己的服务器里的,也就是存的相对路径
//如果不为1,则是存在cnd或别的服务器上,就是存的绝对路径,就不做任何修改
return $data['from'] == 1 ? (config('setting.url_prefix') . $value) : $value;
}
}
中间使用了config助手函数,我将自己的域名放在配置中,方便以后换域名等。
那么现在问题是,这个拼接方法很简单,可是,$value,$data这两个参数是哪里来的。
这时候就该看看我们获取器的用法了。
- 首先获取器是写在Model层的,而且要继承自tp的model类
- 获取器方法名是一个固定的写法 (get驼峰写法的字段名Attr)比如 getUrlAttr
- 获取器会自动接收两个参数,一是读取字段的值,二传入的是当前的所有数据数组
class Image extends BaseModel
{
protected $visible = ['url'];
/**
* 读取器,在读取的时候触发,调用基类中的拼接web域名方法
* @param $value
* @param $data
* @return string
*/
public function getUrlAttr($value, $data)
{
return $this->splicingPrefix($value,$data);
}
}
这样我们tp注入的两个参数拿去调用模型基类中的拼接域名方法。
那么当读取到url这个参数时,首先会触发获取器,获取器会接受$value,$data两个参数,拿到这两个参数后,会到模型基类中去调用拼接域名方法,然后返回,返回到获取器方法之后,获取器又将结果返回。
这样我们在读取url时,读取的就是一个已经被处理过的完整的url了
应用二:
有时候,我们会将数据库中某一个字段来存储一些序列化后的数组。虽然这样做并不太好。但是确实有需求,我们在查数据反回给客户端时,需要反序列化下。如果每次查这条数据的时候都去手动反序列化,就不太方便。
我们看看获取器是如何帮助我们搞定的
我这里就拿地址地址来做比方,我讲地址数据保存在数组中,序列化后存在数据库
在对应的model层中,构建获取器。
public function getSnapAddressAttr($value)
{
if (empty($value)) {
return null;
}
return unserialize($value);
}
这样,在读取地址字段时候,就会自动的反序列化成一个数组。
好啦今天就介绍到这里,比较简单的用法,主要是开阔下思路。