如何使用 WordPress 作为 Laravel 应用程序的后端
发布于 作者 Eric L. Barnes
上周我 重新发布了 Laravel 新闻,新网站使用 Laravel 作为前端,WordPress 作为后端。过去两年我一直在使用 WordPress,我逐渐喜欢上了它提供的功能。发布体验、媒体管理器、移动应用程序和用于跟踪统计数据的 Jetpack。
我还没有准备好放弃这些功能,也没有时间自己构建系统,所以我决定保留 WordPress,并使用一个 API 插件来提取我需要的所有内容,然后将它们存储在我的 Laravel 应用程序中。在本教程中,我想要概述我的全部设置方法。
请记住,有几种不同的方法可以做到这一点,你可以查看 WordPress 和 Laravel 文章,其中列出了其他人创建的第三方包和资源,用于解决相同的任务。主要选项是连接到 WordPress 数据库、从 API 拉取或将数据从一个系统同步到另一个系统。
我选择了同步选项,因为我想将所有内容分开。在研究过程中,我偶然发现了一个名为 WordPressToLaravel 的包,但它只适用于 wordpress.com 托管的网站。
我决定为自托管的 WordPress 安装创建一个自己的系统。此方法在前期需要更多工作,但它允许我的网站成为一个典型的 Laravel 应用程序,我可以轻松地根据需要进行改进和扩展。
在内容同步后,我通过 Laravel 计划程序 将其设置为一个定期任务,因此它是完全自动化的。
我的设置也完全是我需求定制的。我只想拉取帖子、类别和标签。页面和其他部分都由静态 Blade 文件或其他 API 驱动。
让我们看一下整个工作原理。
WordPress API
WordPress 自身没有 API;但是,社区开发了一个名为 WP Rest API 的插件,允许任何博客拥有 jSON API。
在我的情况下,我执行的是只读请求,不需要任何身份验证。这使得读取和获取数据变得容易,并简化了许多代码。
以下是我的用于获取帖子列表的基本类
class WpApi{ protected $url = 'http://site.com/wp-json/wp/v2/'; public function importPosts($page = 1) { $posts = collect($this->getJson($this->url . 'posts/?_embed&filter[orderby]=modified&page=' . $page)); foreach ($posts as $post) { $this->syncPost($post); } } protected function getJson($url) { $response = file_get_contents($url, false); return json_decode( $response ); }}
现在,当你调用 WpAPI->importPosts()
时,它将获取第一页结果。查询字符串值得一提,因为它有一些特殊的子句。第一个是 _embed
,它将嵌入所有额外的數據,如图像嵌入、类别和标签。接下来是一个过滤器,用于按最后修改时间排序,这样当你编辑 WordPress 上的帖子时,它就会出现在第一页结果中,这意味着它会重新同步。
接下来,我们需要能够将帖子与我们的数据库同步。以下是我设置它的方法
protected function syncPost($data){ $found = Post::where('wp_id', $data->id)->first(); if (! $found) { return $this->createPost($data); } if ($found and $found->updated_at->format("Y-m-d H:i:s") < $this->carbonDate($data->modified)->format("Y-m-d H:i:s")) { return $this->updatePost($found, $data); }} protected function carbonDate($date){ return Carbon::parse($date);}
在此步骤中,我在自己的帖子表中添加了一个 wp_id
字段,这样我就可以在本地数据库和 WordPress 之间建立一对一的关系。
接下来,我检查它是否不存在,如果不存在则创建它。否则,如果它自上次同步以来已被修改,则更新它。
createPost
和 updatePost
是典型的 Laravel Eloquent 插入或更新操作。以下是创建代码
protected function createPost($data){ $post = new Post(); $post->id = $data->id; $post->wp_id = $data->id; $post->user_id = $this->getAuthor($data->_embedded->author); $post->title = $data->title->rendered; $post->slug = $data->slug; $post->featured_image = $this->featuredImage($data->_embedded); $post->featured = ($data->sticky) ? 1 : null; $post->excerpt = $data->excerpt->rendered; $post->content = $data->content->rendered; $post->format = $data->format; $post->status = 'publish'; $post->publishes_at = $this->carbonDate($data->date); $post->created_at = $this->carbonDate($data->date); $post->updated_at = $this->carbonDate($data->modified); $post->category_id = $this->getCategory($data->_embedded->{"wp:term"}); $post->save(); $this->syncTags($post, $data->_embedded->{"wp:term"}); return $post;}
如果你仔细观察,你会发现一些特殊情况,例如作者、特色图像、类别和标签。这些数据来自原始查询字符串中的 _embed
,同步这些数据只是与之前操作相同的事情。
public function featuredImage($data){ if (property_exists($data, "wp:featuredmedia")) { $data = head($data->{"wp:featuredmedia"}); if (isset($data->source_url)) { return $data->source_url; } } return null;} public function getCategory($data){ $category = collect($data)->collapse()->where('taxonomy', 'category')->first(); $found = Category::where('wp_id', $category->id)->first(); if ($found) { return $found->id; } $cat = new Category(); $cat->id = $category->id; $cat->wp_id = $category->id; $cat->name = $category->name; $cat->slug = $category->slug; $cat->description = ''; $cat->save(); return $cat->id;} private function syncTags(Post $post, $tags){ $tags = collect($tags)->collapse()->where('taxonomy', 'post_tag')->pluck('name')->toArray(); if (count($tags) > 0) { $post->setTags($tags); }}
对于类别,我提取了帖子分配的第一个类别,因为我只想每个类别一个帖子,然后在 syncTags
中,我使用的是 Cartalyst 的标签包.
创建计划任务
完成导入的最后一步是构建一个计划任务,以自动拉取帖子。我通过 Artisan 创建了一个名为 Importer 的命令
php artisan make:console Importer
然后在 handle
方法中
$page = ($this->argument('page')) ? $this->argument('page') : 1;$this->wpApi->importPosts($page);
最后,在 Console/Kernel
中将其设置为每分钟运行一次
$schedule->command('import:wordpress') ->everyMinute();
现在,每天的每一分钟,它都会尝试同步数据,并创建、更新或忽略帖子。
更进一步
这是我设置此功能的基本概述,它只是触及了所有可以完成的事情的表面。例如,我大量缓存了网站内的所有数据库查询,并且在此同步过程中,如果某些内容被更新,则相关缓存会被清除。
我希望这可以帮助你了解使用 WordPress 作为后端并不难管理,同时它也提供了许多好处,例如从移动设备创建帖子、使用其媒体管理器,甚至使用 Jetpack 以 Markdown 格式编写。