晋太元中,武陵人捕鱼为业。缘溪行,忘路之远近。忽逢桃花林,夹岸数百步,中无杂树,芳草鲜美,落英缤纷。渔人甚异之,复前行,欲穷其林。 林尽水源,便得一山,山有小口,仿佛若有光。便舍船,从口入。初极狭,才通人。复行数十步,豁然开朗。土地平旷,屋舍俨然,有良田、美池、桑竹之属。阡陌交通,鸡犬相闻。其中往来种作,男女衣着,悉如外人。黄发垂髫,并怡然自乐。 见渔人,乃大惊,问所从来。具答之。便要还家,设酒杀鸡作食。村中闻有此人,咸来问讯。自云先世避秦时乱,率妻子邑人来此绝境,不复出焉,遂与外人间隔。问今是何世,乃不知有汉,无论魏晋。此人一一为具言所闻,皆叹惋。余人各复延至其家,皆出酒食。停数日,辞去。此中人语云:“不足为外人道也。”(间隔 一作:隔绝) 既出,得其船,便扶向路,处处志之。及郡下,诣太守,说如此。太守即遣人随其往,寻向所志,遂迷,不复得路。 南阳刘子骥,高尚士也,闻之,欣然规往。未果,寻病终。后遂无问津者。
|
Server : Apache System : Linux srv.rainic.com 4.18.0-553.47.1.el8_10.x86_64 #1 SMP Wed Apr 2 05:45:37 EDT 2025 x86_64 User : rainic ( 1014) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory : /home/rainic/www/oldTZh/wp-content/plugins/wordpress-seo/src/initializers/ |
Upload File : |
<?php
namespace Yoast\WP\SEO\Initializers;
use Exception;
use Yoast\WP\Lib\Migrations\Adapter;
use Yoast\WP\Lib\Migrations\Migration;
use Yoast\WP\SEO\Conditionals\No_Conditionals;
use Yoast\WP\SEO\Config\Migration_Status;
use Yoast\WP\SEO\Loader;
/**
* Triggers database migrations and handles results.
*/
class Migration_Runner implements Initializer_Interface {
use No_Conditionals;
/**
* The migrations adapter.
*
* @var Adapter
*/
protected $adapter;
/**
* The loader.
*
* @var Loader
*/
protected $loader;
/**
* The migration status.
*
* @var Migration_Status
*/
protected $migration_status;
/**
* Retrieves the conditionals for the migrations.
*
* @return array The conditionals.
*/
public static function get_conditionals() {
return [];
}
/**
* Migrations constructor.
*
* @param Migration_Status $migration_status The migration status.
* @param Loader $loader The loader.
* @param Adapter $adapter The migrations adapter.
*/
public function __construct(
Migration_Status $migration_status,
Loader $loader,
Adapter $adapter
) {
$this->migration_status = $migration_status;
$this->loader = $loader;
$this->adapter = $adapter;
}
/**
* Runs this initializer.
*
* @return void
*
* @throws Exception When a migration errored.
*/
public function initialize() {
$this->run_free_migrations();
// The below actions is used for when queries fail, this may happen in a multisite environment when switch_to_blog is used.
\add_action( '_yoast_run_migrations', [ $this, 'run_free_migrations' ] );
}
/**
* Runs the free migrations.
*
* @return void
*
* @throws Exception When a migration errored.
*/
public function run_free_migrations() {
$this->run_migrations( 'free' );
}
/**
* Initializes the migrations.
*
* @param string $name The name of the migration.
* @param string $version The current version.
*
* @return bool True on success, false on failure.
*
* @throws Exception If the migration fails and YOAST_ENVIRONMENT is not production.
*/
public function run_migrations( $name, $version = \WPSEO_VERSION ) {
if ( ! $this->migration_status->should_run_migration( $name, $version ) ) {
return true;
}
if ( ! $this->migration_status->lock_migration( $name ) ) {
return false;
}
$migrations = $this->loader->get_migrations( $name );
if ( $migrations === false ) {
$this->migration_status->set_error( $name, "Could not perform $name migrations. No migrations found.", $version );
return false;
}
try {
$this->adapter->create_schema_version_table();
$all_versions = \array_keys( $migrations );
$migrated_versions = $this->adapter->get_migrated_versions();
$to_do_versions = \array_diff( $all_versions, $migrated_versions );
\sort( $to_do_versions, \SORT_STRING );
foreach ( $to_do_versions as $to_do_version ) {
$class = $migrations[ $to_do_version ];
$this->run_migration( $to_do_version, $class );
}
} catch ( Exception $exception ) {
// Something went wrong...
$this->migration_status->set_error( $name, $exception->getMessage(), $version );
if ( \defined( 'YOAST_ENVIRONMENT' ) && \YOAST_ENVIRONMENT !== 'production' ) {
throw $exception;
}
return false;
}
$this->migration_status->set_success( $name, $version );
return true;
}
/**
* Runs a single migration.
*
* @param string $version The version.
* @param string $migration_class The migration class.
*
* @return void
*
* @throws Exception If the migration failed. Caught by the run_migrations function.
*/
protected function run_migration( $version, $migration_class ) {
/**
* The migration to run.
*
* @var Migration $migration
*/
$migration = new $migration_class( $this->adapter );
try {
$this->adapter->start_transaction();
$migration->up();
$this->adapter->add_version( $version );
$this->adapter->commit_transaction();
} catch ( Exception $e ) {
$this->adapter->rollback_transaction();
throw new Exception( \sprintf( '%s - %s', $migration_class, $e->getMessage() ), 0, $e );
}
}
}