最近带家人去扬州，本想领家人们尝尝地道的扬州炒饭，结果发现之前常去的那家扬州炒饭不在了，打听得知早在疫情刚结束就关闭了。这家店原本开在广陵区政府边上，斜对着石塔寺的那棵大银杏树。老板是扬州本地人，由于老板信佛，佛教文化是戒酒戒肉的，他家的饭食里是没有荤菜的，因此，扬州当地的朋友说他家的扬州炒饭严格来说不是正宗的。对酒也不例外，他家不卖酒，并且不允许客人在店内饮酒，店里会提供那种介绍素食做法的食谱小册子供食客免费取阅，你要是喜欢也可以带走。即便如此，在我心中他仍是一家有特色的扬州炒饭，可惜啊。

意思就是利用 iOS 的快捷指令发日志，不用装 WordPress APP，并且还能实现一些有意思的功能。原理是利用 iOS 的快捷指令调用 WordPress 的 REST API 日志接口。

只需要动手做两个一次性的配置即可

第一步，创建用于验证的应用程序密码

1. 登录 WordPress 后台，在【用户】-【个人资料】页面找到【应用程序密码】，在【新的应用程序密码名称】下方的文本框里随便输入一个标记名称，点下方的【添加新的应用程序密码】按钮，此时，WordPress 会为刚输入的名称创建一个密码，这个密码是接下来用来验证 REST-API 接口的；
   
2. 把刚刚创建的密码记下来，去掉空格，在密码前面加上当前登录的 WordPress 用户名以冒号隔开，比如我登录 WordPress 后台的用户名是root，刚刚创建的应用程序密码是gttc Pvt4 OTD1 8HiE Q3x0 w9pv，处理后就是root:gttcPvt4OTD18HiEQ3x0w9pv
3. 将上一步得到的这串文本进行 Base64 编码，搜一下【base64在线编码】转一下。拿到转换后的文本串，在最前面加上Basic中间加个空格（得到类似这样的文本串Basic cm9vdDpndHRjUHZ0NE9URDE4SGlFUTN4MHc5cHY=），至此，第一步的准备工作已经完成。
   

第二步，配置快捷指令的接口地址和验证信息

1. 点后方链接安装本人分享的快捷指令：https://www.icloud.com/shortcuts/2779823e2c724396ad4dd9dfbf43e24e
2. 点快捷指令右上角的三个点，进入编辑状态，往下滑找到里面有个url键的【词典】块，将url后面的 url 地址改成你自己的，就是你的域名加上/?rest_route=/wp/v2/posts，比如我的就是
   https://域名.com/?rest_route=/wp/v2/posts；
   
3. 词典下面那个块是【网络】，展开，【头部】下面有个Authorization的键，后面的值用第一步准备好的那串 Base64 文本串替换掉，点右上角的【完成】，大功告成。
   

接下来，就可以点刚刚的快捷指令按提示发日志了，但是慢着，看下下面的注意事项。

注意：
1、这个快捷指令只能算是玩玩，不可过度依赖，受网络等不可控因素影响，若发布失败将无法保留草稿记录；
2、用这个快捷指令发日志，需要开定位服务，这个快捷指令会利用定位通过 iOS 的天气服务获取天气、GPS、所在城市等信息，记录在日志的自定义字段里；
3、REST API 日志发布接口对自定义字段的处理策略是先注册再使用，只有已注册的自字段是才会被写入到日志的字段值字段里的，下方的代码，正是用来注册上方快捷指令里的那些自定义字段的，放到主题文件的 function.php 即可。

/**
 * Register meta keys for posts
 * rest api posts 接口只能在 meta 中使用这里注册的自定义字段
 */
function register_brave_post_meta() {
	// 这些是需要注册的自定义字段
	$brave_post_meta = array('geo_latitude', 'geo_longitude', 'geo_city', 'geo_public', 'wx_weather', 'wx_temp', 'post_device_name', 'post_device_ver');
	$arg = array(
					'single'       => true,
					'type'         => 'string',
					'default'      => '',
					'show_in_rest' => true,
				);
	array_walk($brave_post_meta, function ($val, $key, $arg) {register_meta('post', $val, $arg);}, $arg);
}

add_action('init', 'register_brave_post_meta');

在 rest api 出现之前，想暴露一个接口需要先使用 wp_ajax_nopriv_ 或 wp_ajax_ 这两个钩子定义接口，再通过 admin-ajax.php 调用之（调用形式固定为 http://127.0.0.1/wp-admin/admin-ajax.php?action=），有了 rest api 就不用受此限制了，可玩性也大大提高了。

使用 rest api 只需要定义自己的路由和处理函数，就可以通过自定义链接来访问自己的接口了。

注册路由

在主题文件的 function.php 文件中加入下方的钩子，以分别定义 test 和 test2 两个路由

register_rest_route(
		'/v1', // 命名空间, 注意: wp 这两个字符为系统保留使用, 不建议在这里使用
		'/test', // 路由基础路径
		array(
			'methods'  => 'GET,POST', // HTTP METHOD, 支持逗号分割的字符串, 或字符串数组, 如: 'GET,POST' 或 array('POST', 'PUT');
            'callback' => 'func_demo1', // 处理路由请求的最终处理函数
			'permission_callback' => '__return_true', // 这是一个回调函数, 若对外公开需要返回 true; 否则, 返回 false. 可以通过此回调函数来判断处理用户权限. for security
		),
	);
	register_rest_route(
		'/v1',
		'/test2',
		array(
			'methods'  => 'POST',
            'callback' => 'func_demo2',
			'permission_callback' => '__return_true',
		),
	);

add_action('rest_api_init', 'register_brave_router');

添加处理函数

只有路由还不行，还要有对应的路由处理函数，下面在主题文件的 function.php 文件中分别添加 test 和 test2 的路由处理函数。

// test 的处理函数
function func_demo1 () {
	return array('key' => 'hello');
}

// test2 的处理函数
function func_demo2 ($request) {
	$data = wp_unslash($request->get_json_params()); // 取出来接口传入的参数
	return $data; // 返回接口传入的参数
}

访问自定义的接口

有两种方式访问刚刚添加的接口，一种是默认形式链接，一种是固定连接，分别如下

http://127.0.0.1/?rest_route=/v1/test
http://127.0.0.1/wp-json/v1/test

如果使用后者将得到下图这样的响应结果：

自定义前缀

如果不想要 wp-json 这样的前缀，wp 也提供了自定义的钩子，下方的钩子（同样，需要添加到主题文件的 function.php 文件中）将把 wp-json 改为 api。
注意：更改这里的前缀需要到【设置】-【固定链接】, 点一下保存【更改按钮】, 以刷新路由重定向规则使之生效

function rename_brave_rest_url_prefix() {
	return 'api';
}

add_filter('rest_url_prefix', 'rename_brave_rest_url_prefix');

不小心咬破了口腔，最近几天用了这药我终于理解影视剧里那些任凭敌人严刑拷打拒不屈服，往往敌人抓上一小撮盐往伤口上一撒便失节丧气的人了。

今天午饭过后我去血站献了血，献血的原因很直接，老丈人生病住院需要用血。医院告知血液紧张暂时没血，若想尽快用血，就需要家人朋友去血站献血。

去年11月初家人在另一所医院住院，隔壁床位需要用血的老太太也遇到了缺血的问题，同样医生也是催促家属献血。

上述献血行为是定向的，需要献血人在血站告知和登记自己献血的目的是为哪个医院哪个病区几号床的病人供血，并且，不要求献血人跟用血人的血型一致，哪怕病人是O型血，献血人是B型血，也是可以的，亲属献了血病人就有血液可用了。这里有些事情不能明说，总之，就是这样。

献血前一定要吃饭，献血人最近不能感冒发烧，没生过重大疾病，不曾感染过特定的传染性疾病，年龄在18-55岁之间，体重不低于100斤，前一天没有熬夜喝酒，血站工作人员一一询问确认这些情况，核对献血人的身份信息（要带上身份证）。然后，献血人扫二维码填写个人信息阅读确认献血须知，确认献血量（分别有200毫升、300毫升、400毫升三档可选，不过血站的人会尽量推荐你献300毫升或400毫升，其实坚持选200毫升也是可以的）；最后，血站人员会采集献血人的血液现场化验，大约1分钟左右便可知道献血人的血液是否符合标准，符合标准便进入采血环节了。

采血的过程还是比较快的，确认完在哪支胳膊上采血，便安排我坐下。采血操作很简单，工作人员拿过来一套类似医院打吊瓶用的输液设备，其实是一样的，只不过工作方式反了一下：针头扎进血管，血液顺着连接导管流进另一端的储血袋，装满就行了。采血时工作人员提醒说采血的针头比较粗，刚扎进去时会有点疼，建议不要看，我说我不看你扎吧。确实是有点疼的，仔细看那个针头比医院输液用的针头粗了很多，胖一圈都不止。

随后这位工作人员坐旁边问了我一堆问题：在哪上班，休息几天，过年什么时候放假，提醒献完血要多喝水，最近不能剧烈运动高空作业。当然我也问了她一些问题，比如一天有多少人过来献血，比较敏感就不发出来了。没等我将注意力转移到储血袋上，血已经采完了，拔了针按了一会扎针的地方，最后缠上一圈胶带，整个采血环节就结束了。

采完血，工作人员询问有没有不舒服的感觉，让我先喝水休息个15分钟再离开。对了，虽然是定向献血，但也有献血纪念品的，是一只杯子。另外，这个血站虽在闹市人流密集的商场边上，工作人员却只有一个人。从我进门到离开，整个血站总共就工作人员还有我这个献血人两个人，碰巧这几天大降温，外面寒风凛冽，献血屋的空调开的是真足，春天般的温暖，毫不夸张地说这次献血是我有生以来第一次享受这种一对一的公共服务。

关于献血后有没有不适的症状，针对这一问题，我刻意把这篇文章拖了几天再发出来，就是为了观察自己有没有什么不适。总体而言并没有感觉到头晕等不适症状，跟正常时候一样，献完血我就去上班了。献血后的第二天和第三天每晚睡前会有一些畏寒的感觉，即便屋里开了空调也会觉得有些冷，之后就跟往日无异了。