ワードプレスが動くとき、どんなphpが動いているか7:install.php

前回の、ワードプレスが動くとき、どんなphpが動いているか6:setup-config.phpでは、

  • STEP0:DBの設置を促す
  • STEP1:DBの名前パスワード等の入力フォームを表示
  • STEP2:DBの動作確認、認証キーの取得など
  • STEP3:wp-config.phpの作成とSTEP2で用意した情報の書き込み

の処理を確認しました。

STEP3の最後で、install.phpへのリンクをしていました。
DBが整い、wp-config.phpが完成したところで、いよいよインストールという場面になります。

最初のコメント

 * WordPress Installer

というわけで、ずばりインストーラです。

PHPが動いているかをチェック

// Sanity check.
if ( false ) {
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<title>Error: PHP is not running</title>
</head>
<body>
	<h1 id="logo"><img alt="WordPress" src="images/wordpress-logo.png" /></h1>
	<h2>Error: PHP is not running</h2>
	<p>WordPress requires that your web server is running PHP. Your server does not have PHP installed, or PHP is turned off.</p>
</body>
</html>
<?php
}

Sanityは健全さという英語のようです。insaneで狂ってるの元の言葉。
狂っている場合は、PHPが動いてないよ、と表示します。

ファイル群の読み込みと変数$stepのチェック

/**
 * We are installing WordPress.
 *
 * @since 1.5.1
 * @var bool
 */
define( 'WP_INSTALLING', true );

/** Load WordPress Bootstrap */
require_once( dirname( dirname( __FILE__ ) ) . '/wp-load.php' );

/** Load WordPress Administration Upgrade API */
require_once( dirname( __FILE__ ) . '/includes/upgrade.php' );

/** Load wpdb */
require_once(dirname(dirname(__FILE__)) . '/wp-includes/wp-db.php');

$step = isset( $_GET['step'] ) ? $_GET['step'] : 0;

各ファイルの大体の役割。

wp-load.php
wp-config.phpを読み込むファイルで、ここで勉強済み
/includes/upgrade.php
どうも古いバージョンからのアップグレードの際の諸々の変更をやっているらしい
/wp-includes/wp-db.php
ワードプレスからDBにアクセスするためのwpdb関数などが定義されている

変数でステップチェック

$step = isset( $_GET['step'] ) ? $_GET['step'] : 0;

三項演算子、という名前の構文で、if/else文みたいに使える。
条件文 ? trueの場合の処理 : falseの場合の処理;
ということなので、

$_GET[‘step’]が設定されているか?
YES → ゲットの数値を引き継ぐ。
NO → 0を代入する。

という処理になります。

関数display_header()を定義

なんども使うと思われる関数を定義する。

/**
 * Display install header.
 */
function display_header() {
	header( 'Content-Type: text/html; charset=utf-8' );
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" <?php language_attributes(); ?>>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<title><?php _e( 'WordPress &rsaquo; Installation' ); ?></title>
	<?php wp_admin_css( 'install', true ); ?>
</head>
<body>
<h1 id="logo"><img alt="WordPress" src="images/wordpress-logo.png" /></h1>

<?php
} // end display_header()

関数display_setup_form()を定義

既にWPのユーザ名、ブログタイトル、パスワード、メールアドレスが入っているかどうかをチェックし、入っていなければ、入力してもらうためのhtmlを定義しておく。

/**
 * Display installer setup form.
 */
function display_setup_form( $error = null ) {
	global $wpdb;
	$user_table = ( $wpdb->get_var("SHOW TABLES LIKE '$wpdb->users'") != null );

	// Ensure that Blogs appear in search engines by default
	$blog_public = 1;
	if ( ! empty( $_POST ) )
		$blog_public = isset( $_POST['blog_public'] );

	$weblog_title = isset( $_POST['weblog_title'] ) ? trim( stripslashes( $_POST['weblog_title'] ) ) : '';
	$user_name = isset($_POST['user_name']) ? trim( stripslashes( $_POST['user_name'] ) ) : 'admin';
	$admin_password = isset($_POST['admin_password']) ? trim( stripslashes( $_POST['admin_password'] ) ) : '';
	$admin_email  = isset( $_POST['admin_email']  ) ? trim( stripslashes( $_POST['admin_email'] ) ) : '';

	if ( ! is_null( $error ) ) {
?>
<p class="message"><?php printf( __( '<strong>ERROR</strong>: %s' ), $error ); ?></p>
<?php } ?>
<form id="setup" method="post" action="install.php?step=2">
	<table class="form-table">
		<tr>
			<th scope="row"><label for="weblog_title"><?php _e( 'Site Title' ); ?></label></th>
			<td><input name="weblog_title" type="text" id="weblog_title" size="25" value="<?php echo esc_attr( $weblog_title ); ?>" /></td>
		</tr>
		<tr>
			<th scope="row"><label for="user_name"><?php _e('Username'); ?></label></th>
			<td>
			<?php
			if ( $user_table ) {
				_e('User(s) already exists.');
			} else {
				?><input name="user_name" type="text" id="user_login" size="25" value="<?php echo esc_attr( sanitize_user( $user_name, true ) ); ?>" />
				<p><?php _e( 'Usernames can have only alphanumeric characters, spaces, underscores, hyphens, periods and the @ symbol.' ); ?></p>
			<?php
			} ?>
			</td>
		</tr>
		<?php if ( ! $user_table ) : ?>
		<tr>
			<th scope="row">
				<label for="admin_password"><?php _e('Password, twice'); ?></label>
				<p><?php _e('A password will be automatically generated for you if you leave this blank.'); ?></p>
			</th>
			<td>
				<input name="admin_password" type="password" id="pass1" size="25" value="" />
				<p><input name="admin_password2" type="password" id="pass2" size="25" value="" /></p>
				<div id="pass-strength-result"><?php _e('Strength indicator'); ?></div>
				<p><?php _e('Hint: The password should be at least seven characters long. To make it stronger, use upper and lower case letters, numbers and symbols like ! " ? $ % ^ &amp; ).'); ?></p>
			</td>
		</tr>
		<?php endif; ?>
		<tr>
			<th scope="row"><label for="admin_email"><?php _e( 'Your E-mail' ); ?></label></th>
			<td><input name="admin_email" type="text" id="admin_email" size="25" value="<?php echo esc_attr( $admin_email ); ?>" />
			<p><?php _e( 'Double-check your email address before continuing.' ); ?></p></td>
		</tr>
		<tr>
			<td colspan="2"><label><input type="checkbox" name="blog_public" value="1" <?php checked( $blog_public ); ?> /> <?php _e( 'Allow my site to appear in search engines like Google and Technorati.' ); ?></label></td>
		</tr>
	</table>
	<p class="step"><input type="submit" name="Submit" value="<?php esc_attr_e( 'Install WordPress' ); ?>" class="button" /></p>
</form>
<?php
} // end display_setup_form()

グローバル宣言

global $wpdb;

これは、このdisplay_setup_form()という関数の中で、どこかよその場所で定義されている変数の値を使いたい時に、行う宣言。$wpdbは、データベースと対話するために設定されたクラスをインスタンス化したものです。詳細は、関数リファレンス/wpdb Classを参照する。

get_var関数とSHOW構文/LIKE検索

$user_table = ( $wpdb->get_var("SHOW TABLES LIKE '$wpdb->users'") != null );


ここに書いてあるように
get_var関数は、
データベースから変数を一つ返します。変数は一つしか返ってきませんが、クエリの結果はすべてキャッシュされ、あとから使うことができます。結果にマッチするものがない場合、NULL が返されます。
というものです。

SHOW TABLES LIKEはSQL構文で、SHOWは表示、LIKEはあいまい検索です。

従って、WordPressのusersテーブルを参照した返り値 != null を$user_table変数に代入しています。
「空っぽではない」をtrueにして代入している感じだと思います。

その他の変数に、ブログの情報を代入

	$weblog_title = isset( $_POST['weblog_title'] ) ? trim( stripslashes( $_POST['weblog_title'] ) ) : '';
	$user_name = isset($_POST['user_name']) ? trim( stripslashes( $_POST['user_name'] ) ) : 'admin';
	$admin_password = isset($_POST['admin_password']) ? trim( stripslashes( $_POST['admin_password'] ) ) : '';
	$admin_email  = isset( $_POST['admin_email']  ) ? trim( stripslashes( $_POST['admin_email'] ) ) : '';

これらの4つでは三項演算子が使われていて、ポストでブログタイトルやパスワードなどを受け取っていればそれらを代入し、何もなければ空白を代入します。

エラーチェック

	if ( ! is_null( $error ) ) {
?>
<p class="message"><?php printf( __( '<strong>ERROR</strong>: %s' ), $error ); ?></p>
<?php } ?>

エラーがあれば、エラーを告げるようです。printf関数でなんか$errorの内容を文字列にして表示しています。

フォーム

<form id="setup" method="post" action="install.php?step=2">
</form>

このフォームでもろもろ記述をさせますが、action=”install.php?step=2″としているので、同じファイルに帰ってくるけれども、$step=2になって帰って来るようになってます。

フォームの中身

$admin_emailなどがポストされている場合とされていない場合で、表示される内容が異なるように書かれている。次のステップでは、表示されているはずなので、それらが表示される仕組み。

ここまでで、関数display_setup_form()の定義が完了。

インストール済みかどうかのチェック

// Let's check to make sure WP isn't already installed.
if ( is_blog_installed() ) {
	display_header();
	die( '<h1>' . __( 'Already Installed' ) . '</h1><p>' . __( 'You appear to have already installed WordPress. To reinstall please clear your old database tables first.' ) . '</p><p class="step"><a href="../wp-login.php" class="button">' . __('Log In') . '</a></p></body></html>' );

ヘッダー表示と、フォーム表示の関数を定義したのでいよいよ処理に入るけど、そのまえに、インストール済みだったら、それを告げて処理を終了(die)。

バージョンチェック

$php_version    = phpversion();
$mysql_version  = $wpdb->db_version();
$php_compat     = version_compare( $php_version, $required_php_version, '>=' );
$mysql_compat   = version_compare( $mysql_version, $required_mysql_version, '>=' ) || file_exists( WP_CONTENT_DIR . '/db.php' );

if ( !$mysql_compat && !$php_compat )
	$compat = sprintf( __('You cannot install because <a href="http://codex.wordpress.org/Version_%1$s">WordPress %1$s</a> requires PHP version %2$s or higher and MySQL version %3$s or higher. You are running PHP version %4$s and MySQL version %5$s.'), $wp_version, $required_php_version, $required_mysql_version, $php_version, $mysql_version );
elseif ( !$php_compat )
	$compat = sprintf( __('You cannot install because <a href="http://codex.wordpress.org/Version_%1$s">WordPress %1$s</a> requires PHP version %2$s or higher. You are running version %3$s.'), $wp_version, $required_php_version, $php_version );
elseif ( !$mysql_compat )
	$compat = sprintf( __('You cannot install because <a href="http://codex.wordpress.org/Version_%1$s">WordPress %1$s</a> requires MySQL version %2$s or higher. You are running version %3$s.'), $wp_version, $required_mysql_version, $mysql_version );

if ( !$mysql_compat || !$php_compat ) {
	display_header();
	die('<h1>' . __('Insufficient Requirements') . '</h1><p>' . $compat . '</p></body></html>');
}

PHPバージョン、MySQLバージョンが適正化どうかをチェックしてNGならエラーメッセージを表示して処理終了です。

$stepの値により、条件分岐しつつ処理を進めます。

このファイルで使う関数の定義、バージョンなどのチェックなどが済んだので、$stepの値により条件分岐させつつ、処理を進めます。

$step=0, $step=1の場合

switch($step) {
	case 0: // Step 1
	case 1: // Step 1, direct link.
	  display_header();
?>
<h1><?php _e( 'Welcome' ); ?></h1>
<p><?php printf( __( 'Welcome to the famous five minute WordPress installation process! You may want to browse the <a href="%s">ReadMe documentation</a> at your leisure. Otherwise, just fill in the information below and you&#8217;ll be on your way to using the most extendable and powerful personal publishing platform in the world.' ), '../readme.html' ); ?></p>

<h1><?php _e( 'Information needed' ); ?></h1>
<p><?php _e( 'Please provide the following information. Don&#8217;t worry, you can always change these settings later.' ); ?></p>

<?php
		display_setup_form();
		break;

「5分で済むプロセスですよ。下記のフォームをおねがいしますね。あとで変えられるので」というメッセージとともに、ステップに応じたフォームを表示します。

$step=0の時のフォームは、まだ何も情報がない状態なので、全て空欄のフォーム。
$step=1の時は、前回のsetup-config.phpからではないところから来ているのか?

このフォームの内容をもとに、action=”?step=2″を含みつつフォームを送信。

$step = 2の場合

	case 2:
		if ( ! empty( $wpdb->error ) )
			wp_die( $wpdb->error->get_error_message() );

		display_header();
		// Fill in the data we gathered
		$weblog_title = isset( $_POST['weblog_title'] ) ? trim( stripslashes( $_POST['weblog_title'] ) ) : '';
		$user_name = isset($_POST['user_name']) ? trim( stripslashes( $_POST['user_name'] ) ) : 'admin';
		$admin_password = isset($_POST['admin_password']) ? $_POST['admin_password'] : '';
		$admin_password_check = isset($_POST['admin_password2']) ? $_POST['admin_password2'] : '';
		$admin_email  = isset( $_POST['admin_email']  ) ?trim( stripslashes( $_POST['admin_email'] ) ) : '';
		$public       = isset( $_POST['blog_public']  ) ? (int) $_POST['blog_public'] : 0;
		// check e-mail address
		$error = false;
		if ( empty( $user_name ) ) {
			// TODO: poka-yoke
			display_setup_form( __('you must provide a valid username.') );
			$error = true;
		} elseif ( $user_name != sanitize_user( $user_name, true ) ) {
			display_setup_form( __('the username you provided has invalid characters.') );
			$error = true;
		} elseif ( $admin_password != $admin_password_check ) {
			// TODO: poka-yoke
			display_setup_form( __( 'your passwords do not match. Please try again' ) );
			$error = true;
		} else if ( empty( $admin_email ) ) {
			// TODO: poka-yoke
			display_setup_form( __( 'you must provide an e-mail address.' ) );
			$error = true;
		} elseif ( ! is_email( $admin_email ) ) {
			// TODO: poka-yoke
			display_setup_form( __( 'that isn&#8217;t a valid e-mail address.  E-mail addresses look like: <code>username@example.com</code>' ) );
			$error = true;
		}

		if ( $error === false ) {
			$wpdb->show_errors();
			$result = wp_install($weblog_title, $user_name, $admin_email, $public, '', $admin_password);
			extract( $result, EXTR_SKIP );
?>

<h1><?php _e( 'Success!' ); ?></h1>

<p><?php _e( 'WordPress has been installed. Were you expecting more steps? Sorry to disappoint.' ); ?></p>

<table class="form-table">
	<tr>
		<th><?php _e( 'Username' ); ?></th>
		<td><code><?php echo esc_html( sanitize_user( $user_name, true ) ); ?></code></td>
	</tr>
	<tr>
		<th><?php _e( 'Password' ); ?></th>
		<td><?php
		if ( ! empty( $password ) && empty($admin_password_check) )
			echo '<code>'. esc_html($password) .'</code><br />';
		echo "<p>$password_message</p>"; ?>
		</td>
	</tr>
</table>

<p class="step"><a href="../wp-login.php" class="button"><?php _e( 'Log In' ); ?></a></p>

<?php
		}
		break;
}

エラーが発生すれば、エラーを表示し、成功していればユーザ名とパスワードを表示しつつログインへ向かうリンク。

以上です。

次は、login.phpへと進むことになります。

この記事が気に入ったら
フォローしてね!

よかったらシェアしてね!

著者について

コメント

コメントする

目次
閉じる