分类 PHP 下的文章

WordPress 使用 wp 命令创建 .opt 文件用以支持多语言

作者: Shine
时间: 2021-07-20
分类: PHP
评论

## 前言

> 个人所理解，如有错误请指正

首先需要明白一件事情，创建 `.opt` 文件前，首先在你的插件注释里添加以下关键注释（**Text Domain** 和 **Domain Path** 字段）：

- **Text Domain**：文本域（个人理解），这个比较关键
- **Domain Path**：翻译文件存放的路径

```
/**
 * Plugin Name: 插件的名字
 * Plugin URI: https://nowtime.cc/
 * Description: 插件简介
 * Version: 0.0.1
 * Author: Chuwen
 * Author URI: https://nowtime.cc
 * Text Domain: chuwen
 * Domain Path: /i18n/languages/
 * Requires at least: 5.5
 * Requires PHP: 7.0
 *
 * @package Chuwen
 * @date    2021/7/20 14:50
 */
```

以上工作完成后，就可以接着往下看了

## 安装 wp 命令

> WP-CLI 是一款用于管理 WordPress 的命令行交互界面，无需浏览器即可完成插件更新，多站点设置等许多操作。

官网地址：https://wp-cli.org/zh-cn/
[官方]安装文档：[https://wp-cli.org/zh-cn/#安装](https://wp-cli.org/zh-cn/#安装 "https://wp-cli.org/zh-cn/#安装")

### 本文主要介绍 macOS 以及 Linux 系统安装

#### Linux 安装教程

```shell
cd ~
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

# 检查 Phar 文件确保其正常运行：
php wp-cli.phar --info

# 要使用 wp 执行 WP-CLI 命令，必须有执行权限并且 PATH 已在环境变量中注册，例如：
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

# 最后再次验证
wp --info
```

#### macOS 可以借助 Homebrew 进行安装

> Homebrew 官方安装文档：https://docs.brew.sh/Installation
> 其安装教程可参照：https://zhuanlan.zhihu.com/p/111014448

Homebrew 安装完成后，执行 `brew install wp-cli` 即可

#### Windows 安装教程

> 自行网上搜索，因为**某些功能在 Windows 中将受到限制**，所以我推荐在 Windows 10 以及以上的系统，安装 WSL（Windows 子系统），然后参照 Linux 系统安装 `wp` 命令即可

### 验证安装 wp 命令

输入 `wp --info` 即可验证

![输入 wp --info 验证安装结果](https://cdn.nowtime.cc/2021/07/20/1827334578.png)

```shell
chuwen@MiBook# wp --info
OS:	Darwin 19.6.0 Darwin Kernel Version 19.6.0: Thu Oct 29 22:56:45 PDT 2020; root:xnu-6153.141.2.2~1/RELEASE_X86_64 x86_64
Shell:	/bin/zsh
PHP binary:	/usr/local/Cellar/php@7.3/7.3.28/bin/php
PHP version:	7.3.28
php.ini used:	/usr/local/etc/php/7.3/php.ini
MySQL binary:	
MySQL version:	
SQL modes:	
WP-CLI root dir:	phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir:	phar://wp-cli.phar/vendor
WP_CLI phar path:	/Users/chuwen
WP-CLI packages dir:	
WP-CLI global config:	
WP-CLI project config:	
WP-CLI version:	2.5.0
```

## 生成 `.pot` 文件

- 假设你的 WordPress 根目录是：`/www/wwwroot/wordpress.com`
- 假设你的 WordPress 插件目录：`/www/wwwroot/wordpress.com/wp-content/plugins/chuwen`

首先进入的你的**插件目录**

```shell
cd /www/wwwroot/wordpress.com/wp-content/plugins/chuwen
```

然后生成 `.opt` 文件

```shell
# 如果你是按照最开头的做法做的，那么会自动将生成的 `.opt` 文件放到 `Domain Path` 文件夹下
wp i18n make-pot .

# 如果你想指定文件存放路径、文件名
wp i18n make-pot . i18n/languages/chuwen.pot
```

最后生成结果查看你插件目录下的 `i18n/languages/` 里面的文件即可

### 生成多语言

将生成的比如 `chuwen.pot` 复制一份，将其命名为 `en_US.pot`，然后使用工具进行翻译即可

WordPress 使用 CloudFlare 后，后台无法进入、重定向次数过多、提示 Sorry, you are not allowed to access this page.

作者: Shine
时间: 2021-07-10
分类: PHP
评论

目录/时间线 Typecho 自定义模板

作者: Shine
时间: 2021-07-04
分类: PHP
1 条评论

## 使用说明

如果你使用的是 Typecho 默认主题，那么你可以在你博客目录下 `/www/wwwroot/nowtime.cc/usr/themes/default` 新建一个文件名为 `time-line.php`

然后将下述**模板源码**粘贴进去保存

> 其它主题可以参照着你主题目录下的 `page.php` 源码来修改我下面写的**模板源码**

然后去博客后台 -> 管理 -> 独立页面 -> 新增，选择模板

![](https://cdn.nowtime.cc/2021/07/04/623357964.png)

然后“发布页面即可”

### 效果预览

https://nowtime.cc/time-line.html

![https://nowtime.cc/time-line.html](https://cdn.nowtime.cc/2021/07/04/3640778185.png)

## 模板源码

```php
<?php
/**
 * 目录/时间线
 *
 * @package custom
 */
?>

<?php if (!defined('__TYPECHO_ROOT_DIR__')) exit; ?>
<?php $this->need('header.php'); ?>

/*自定义的 CSS 样式*/
    .editormd-html-preview, .editormd-preview-container{min-height: 0!important;padding: 8px;}
</style>

<div class="col-mb-12 col-8" id="main" role="main">
    <article class="post" itemscope itemtype="http://schema.org/BlogPosting">
        <h1 class="post-title" itemprop="name headline"><a itemprop="url" href="<?php $this->permalink() ?>"><?php $this->title() ?></a></h1>
        <div class="post-content" itemprop="articleBody">
            <?php $this->content(); ?>
            
            <div class="time-line"></div>
        </div>
    </article>
    <?php $this->need('comments.php'); ?>
</div>

<?php
$this->widget("Widget_Contents_Post_Recent", "pageSize=100000000000000")->to($post);
$recentPost = array();
while ($post->next()) {
    $recentPost[] = array(
        "title" => $post->title,
        "link" => $post->permalink,
        "time" => $post->created,
    );
}
?>

//调用函数，渲染“时间线”
    xuanran_time_line(data);

/**
     * 渲染时间线
     * @param data {[]}            需要进行时间线分割的数据
     * @param selector string      css 选择器
     */
    function xuanran_time_line(data = [], selector = ".time-line") {
        let time_line = document.querySelector(selector);
        let _group_month = group_month(data), html;

time_line.innerHTML = '';//清空时间线
        for (let item in _group_month) {
            html = '<li class="tl-header">\n' +
                '    <h2>' + item + '</h2>\n' +
                '</li>' +
                '<ul class="tl-body">';

for (let items in _group_month[item]) {
                ttt = _group_month[item][items];
                html += '<li>\n' +
                    '    <span>' + time_d(ttt["time"]) + '</span>\n' +
                    '    <h3>\n' +
                    '        <a href="' + ttt["link"] + '" target="_blank">' + ttt["title"] + '</a>\n' +
                    '    </h3>\n' +
                    '</li>\n'
            }
            html += '</ul>';

time_line.innerHTML += html;
        }
        time_line.innerHTML += '<li class="tl-header start">\n' +
            '    <h2>开始</h2>\n' +
            '</li>';
    }

/**
     * 按月份分组
     * @param data {[]}
     * @returns {[]}
     */
    function group_month(data) {
        let result = [];

for (let item in data) {
            date = time_ym(data[item]['time']);

if (!result[date]) {
                result[date] = [data[item]];
            } else {
                result[date].push(data[item]);
            }
        }

return result;
    }

/**
     * 时间戳{秒级} 转 年月
     * @param dates
     * @returns {string}
     */
    function time_ym(dates) {
        let date = new Date(dates * 1000);

let Y = date.getFullYear() + '年';
        let M = (date.getMonth() + 1 < 10 ? '0' + (date.getMonth() + 1) : date.getMonth() + 1) + '月';

return Y + M;
    }

/**
     * 时间戳{秒级} 转 日
     * @param dates
     * @returns {string}
     */
    function time_d(dates) {
        let date = new Date(dates * 1000);
        return (date.getDate() < 10 ? '0' + (date.getDate()) : date.getDate()) + '日';
    }
</script>

<?php $this->need('sidebar.php'); ?>
<?php $this->need('footer.php'); ?>

```

Hyperf 使用 @date、@datetime 注释启动都报错

作者: Shine
时间: 2021-07-03
分类: PHP
评论

Hyperf 使用 @date、@datetime 注释启动都报错

### 使用 @date 注释

代码如下：
```php
<?php

declare(strict_types=1);

namespace App\Controller\V1\Video;

use App\Controller\V1\BaseController;
use Hyperf\HttpServer\Contract\RequestInterface;
use Hyperf\HttpServer\Contract\ResponseInterface;

class DouyinController extends BaseController
{
    /**
     * @param \Hyperf\HttpServer\Contract\RequestInterface  $request
     * @param \Hyperf\HttpServer\Contract\ResponseInterface $response
     *
     * @return \Psr\Http\Message\ResponseInterface
     *
     * @author  : Chuwen <wenzhouchan@gmail.com>
     * @date: 2021/7/3 12:28
     */
    public function index(RequestInterface $request, ResponseInterface $response): \Psr\Http\Message\ResponseInterface
    {
        return $response->raw($this->help());
    }
}
```

报错：
```log
#4 /www/wwwroot/NowTool/vendor/hyperf/d in /www/wwwroot/NowTool/vendor/doctrine/annotations/lib/Doctrine/Common/Annotations/AnnotationException.php on line 39

Fatal error: Uncaught Doctrine\Common\Annotations\AnnotationException: [Semantical Error] The annotation "@date" in method App\Controller\V1\Video\DouyinController::index() was never imported. Did you maybe forget to add a "use" statement for this annotation? in /www/wwwroot/NowTool/vendor/doctrine/annotations/lib/Doctrine/Common/Annotations/AnnotationException.php:39
Stack trace:
```

### 使用 @datetime 注释

又报以下错误：
```log
Fatal error: Uncaught Doctrine\Common\Annotations\AnnotationException: [Semantical Error] The class "datetime" is not annotated with @Annotation.
Are you sure this class can be used as annotation?
If so, then you need to add @Annotation to the _class_ doc comment of "datetime".
If it is indeed no annotation, then you need to add @IgnoreAnnotation("datetime") to the _class_ doc comment of method App\Controller\V1\Video\DouyinController::index(). in /www/wwwroot/NowTool/vendor/doctrine/annotations/lib/Doctrine/Common/Annotations/AnnotationException.php:39
Stack trace:
```

> The class "datetime" is not annotated with @Annotation.
Are you sure this class can be used as annotation?
If so, then you need to add @Annotation to the _class_ doc comment of "datetime".

### 看到以上错误大概需要怎么做了

参照文档的“注解”部分：https://hyperf.wiki/2.1/#/zh-cn/annotation

解决办法就是，添加需要忽略“注解”，配置文件位置 `/config/autoload/annotations.php`：

![](https://cdn.nowtime.cc/2021/07/03/7126507.png)

然后就可以正常启动了

![](https://cdn.nowtime.cc/2021/07/03/1670611706.png)

Laravel 添加模型方法注释，使 PHPStorm 有语法提示

作者: Shine
时间: 2021-06-30
分类: Laravel,PHP
评论

WordPress 使用 wp 命令创建 .opt 文件用以支持多语言

WordPress 使用 CloudFlare 后，后台无法进入、重定向次数过多、提示 Sorry, you are not allowed to access this page.

目录/时间线 Typecho 自定义模板

Hyperf 使用 @date、@datetime 注释启动都报错

Laravel 添加模型方法注释，使 PHPStorm 有语法提示

最新文章

最近回复

分类

归档

其它