「インストールガイド」を編集中

<metadesc>baserCMSのインストール方法です。</metadesc>

baserCMSのインストールは簡単です。このページでは事前準備とインストール完了までの流れについて説明しています。

== 動作環境 ==
最新の動作環境は公式サイトの[http://basercms.net/about/system システム要件]をご覧ください。

インストールを始める前に「[[レンタルサーバー毎の設定]]」をご確認ください。現時点で解決済みの古い情報がある可能性もありますので、何か問題が発生した時点で対応してください。

[WordPressとの共存]

== baserCMSのダウンロード ==
baserCMSは公式サイトまたはgitHubからダウンロードできます。通常は公式サイトよりダウンロードします。
*[https://basercms.net baserCMS公式サイト]　-上部メニュー「ダウンロード」「コアダウンロード」よりダウンロードできます。
*[https://github.com/basercms/basercms gitHub]　-gitHub baserCMSのリポジトリ　

== サーバーへのアップロード ==

* FTPなどを使って、ファイル一式を全てWEBサーバーの任意のフォルダにアップロードします。

<small>※ baserCMSはサブフォルダでも動作可能です。</small>

== インストールの開始 ==

baserCMSを、https://example.com/ としてインストールするものとして説明します。

<span style="color:red;">インストールを開始します。</span>

[[ファイル:install1.png]]

* ブラウザでbaserCMSを設置したフォルダのトップページにアクセスするとインストールページが表示されます。<br /> （例） https://example.com/
* まずは、説明文をよく読んで「次のステップ」をクリックするとステップ２のページに進みます。

## ステップ２

<span style="color:red;">環境チェックを行います。</span>

[[ファイル:install2.png]]

* ステップ２のページが表示される際、サーバーの環境を自動的に調査しその結果が表示されます。
* 基本必須条件を全て満たせばインストールの準備は完了です。満たしていない箇所を一つずつ解消していきます。<br />
<small>※ 各ディレクトリの書き込み権限は、707 （サーバーによっては777）に設定します。</small>
* **<span style="color:red;">基本必須条件の全ての項目を満たすまで</span>**、「再チェック」ボタンをクリックして再チェックを行います。
* 基本必須条件の全ての項目を満たした時点で、「次のステップへ」というボタンが表示されます。
* 「次のステップへ」をクリックするとステップ３のページに進みます。

## ステップ３

<span style="color:red;">データベースの選択を行います。</span>

[[ファイル:install3.png]]

* MySQL・PostgreSQL・SQLite3 の３つから選択できます。最も普及していてネット上の情報が充実しているのはMySQL、タイトな運用が求められる業務システムなどで支持されているのはPostgreSQL、事前の準備やユーザ名・パスワードなどの設定が不要で初心者でも手軽に扱えるのはSQLiteです。
* MySQL、PostgreSQLを選択した場合には、ホスト名、ユーザー名、パスワード、データベース名の情報を入力し接続テストを行います。<br /> すでに他のアプリケーションで利用しているデータベースを利用する場合には、プレフィックス文字列を指定すれば共存できます<br />
* MySQL、PostgreSQLを選択した場合には、事前にデータベースの準備を行っておく必要があります。
* 「次のステップへ」をクリックするとデータベースを初期化して、ステップ４のページに進みます。

## ステップ４


<span style="color:red;">管理ユーザーの登録を行います。</span>

[[ファイル:install4.png]]


* 管理用のEメールや、管理画面にログインする為の、管理者名、パスワードを入力します。<br />
<small>※ 管理者名、パスワードは半角アルファベットと数字の組み合わせで入力して下さい。</small>
* 「完了」をクリックするとインストールは完了です。インストール完了ページに進みます。

## インストール完了



<span style="color:red;">さあ、baserCMSをはじめましょう。</span>

[[ファイル:install5.png]]

* これでインストールは完了です。お疲れさまでした。<br /> まずは、正常にインストールされているか、トップページや管理者ページの確認を行いましょう。

## インストール完了後

### スマートURLについて

baserCMS は、環境に応じて２種類の URL 形式をとる事ができます。

* [パターン１] スマートURL有効：<br /> （例） https://example.com/contact/index
* [パターン２] スマートURL無効：<br /> （例） https://example.com/index.php/contact/index

### 手動でスマートURLを設定する

短かい「パターン１」が望ましいですが、サーバー環境によっては、「パターン２」だけしか利用できない場合もあります。<br /> 「パターン１」を利用するには、 WEBサーバーに「Rewrite」というモジュールがインストールされていて、 .htaccess という設定ファイルが利用できる事が前提となります。

<small>※ほとんどのレンタルサーバーでは上記条件を満たしていますが、稀に満たしていないサーバーもあります。</small>

管理システムよりのスマートURL設定がうまくいかない場合は、手作業で設定する事もできます。<br /> 詳しくは、[スマートURLについて][11] を参考にしてください。

  [11]: http://wiki.basercms.net/%E3%82%B9%E3%83%9E%E3%83%BC%E3%83%88URL


=== トラブルシューティング ===
インストール時によくあるトラブルをまとめています。

==== エラーメッセージが出る ====
インストールを開始しようとしたら、以下の様なエラーメッセージが複数出て、先へ進まない事があります。

<pre>
Deprecated: Assigning the return value of new by reference is deprecated in ****\basercms\cake\libs\*****.php on line ***
</pre>

PHPのバージョンによる現象ですが、以下のファイルの中にある『=&』を『=』に書き換えることで、対応できる場合があります。
* /cake/lib/configre.php
* /cake/libs/inflector.php
なお、この処理を行った後、表示が崩れたままになる場合があります。エラーが出た当時のCSSをブラウザがキャッシュしているのが原因です。ブラウザキャッシュの削除を行なって、正常なCSSを読み込んで下さい。
　
==== 再インストール ====
「[http://wiki.basercms.net/%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E5%A4%B1%E6%95%97%E6%99%82%E3%81%AE%E5%AF%BE%E5%87%A6%E6%96%B9%E6%B3%95 インストール失敗時の対処]」を参照してください。

== バージョンアップ ==
baserCMSの新バージョンがリリースされる度に、必要作業が[https://basercms.net/ 公式サイト]でアナウンスされます。その手順に従えば、基本的に誰でもバージョンアップ作業をすることが可能です。ただし、[http://b-comi.com/service/b_sup#BsupVer 有償でのサービス]もあり、複数バージョンをまたいだアップデートや、自身での作業に自信がない場合に利用できます。


==WordPressとの共存 ==
baserCMS ver.4.0.5以降であれば、そのindex.phpをリネームし.htaccessを調整することによって、WordPressと同じディレクトリへインストールできます。index.phpをリネームするのはWordPressでも同名ファイルを使用するからですが、index.phpをリネームする以上、.htaccessを変更しなければ正常なルーティングが働かないため、結果としてこの２つを書き換える事になります。以下の例はbaserCMSのindex.phpをindex_basercms.phpに変更し、archive配下（WPの管理画面から記事のパーマリンクをarchiveに設定）をWPで表示する場合で、変更後の.htaccessを示しています。
<pre>
#WordPressとbaserCMSの共存
#両方のインストールを完了させる
#baserCMSの配置を変更
#baserCMSをスマートURLに（4.0.5ではデフォルトでスマートURLはONになっている）。
#WordPressのRewrite設定を行う。
#baserCMSの index.php を index_basercms.php に変更
#.htaccess を下記に書き換える
#（例）archives 配下のみWordPressにしたい場合

RewriteEngine On
RewriteBase /

# トップページ（baserCMS）
RewriteRule ^$ index_basercms.php [L]

# WordPress
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} ^/archives/ [NC]
RewriteRule . /index.php [L]

# baserCMS
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index_basercms.php [QSA,L]
</pre>


== 脚注 ==
<references/>


== 外部参考リンク ==
*[http://naka7772.blog.fc2.com/blog-entry-219.html 初心者がWEB開発に挑戦]　-baserCMSインストール時の表示崩れ対策
*[http://d.hatena.ne.jp/masyura7001/20111224/1324690732 へたれWEB制作者のめもちょう]　-baserCMSをWindowsXPのローカル環境にインストールする(Win７でも可能)

<br /><br />
''テキスト寄贈：[http://hiniarata.jp/ 馬庭 吾一@株式会社ヒニアラタ]''
[[Category:利用ガイド]]