Skip to content

Latest commit

 

History

History
86 lines (63 loc) · 6.44 KB

README.md

File metadata and controls

86 lines (63 loc) · 6.44 KB
Raw

X-update （えっくす・あっぷでーと）

アップデートモジュール「X-update」をXCL (Xoops Cube Legacy) 2.2 以降にインストールすることで、XCL本体や他のモジュールやテーマのインストール、アップデートをFTPクライアントを使わずに迅速に行うことが可能になります。

X-update導入により、サイト管理者は管理サイトにログインして管理画面のアップデータモジュール操作をブラウザ上で行うだけで、モジュールのgitHubなど配布サイトからのダウンロードからインストールやアップデート、テーマのインストールなどが完了します。 もちろん、d3形式などの複製対応モジュールも、インストールモジュール名（＝公開側のフォルダ名称）を変更してインストールすることができます。

このモジュールを使うメリットは、ユーザー側だけに留まりません。　モジュールやテーマ作者も、常に最新の公開リポジトリからxupdateが取得してくれることと、複数の公開先を持つことによる２重管理の手間からも開放されます。

何ができるの？

  • FTPクライアントソフトにノータッチで、対応モジュールやテーマをインストールできます。
  • 対応モジュールやテーマの最新版を、xupdateの管理画面操作だけで各公開サーバーからダウンロード取得し、解凍・展開・アップロードまでできますから、その後で通常のモジュールインストール操作を行うだけです。
  • モジュールだけではなく、テーマやプリロードもストアサイトからダウンロード取得～アップロードまでできます。

動作要件

X-updateを使うためには、以下の環境が必須となります。

  • PHP 5.1.0 以上
  • PHP cURLエクステンション
  • MySQL 5.0 以上
  • Xoops Cube legacy 2.2.0 以上

使い方

ダウンロード

本モジュールを同梱した、XOOPS X(ten) CorePackがありますので、サイトを始めから構築する場合はXOOPS Cube Legacy2.2のインストールから一括して可能なCorePackからの導入をお勧めします。

インストール

通常の、xoops_trust_path式の複製対応モジュールと同様です。 但し、次のディレクトリに書き込み(ファイル作成)権限 (777 とか 707 など) が必要です。管理画面で変更した場合には、変更したディレクトリに書き込み権限を与えて下さい。

  • xoops_trust_path/uploads/xupdate

一般設定

  • 圧縮ファイルダウンロード・展開用フォルダ

  • アーカイブをダウンロードして展開するために使用するフォルダ。(xoops_trust_path)配下のディレクトリを指定、最初と最後の"/"（スラッシュ）は含めません。通常は、uploads/xupdate　のままでご使用ください。 このフォルダには、707,777 などの書き込み権限を与えてください。

  • 使用するFTPライブラリ

    • サーバーにファイル群をアップロードする際に使用するFTPライブラリの選択。カスタムFTP（標準）を選択して問題が解決できない場合、 PHP_FTP（FTP over SSL用）や、カスタムSSH_FTPをお試しください。
      • カスタムFTP（標準）
        • PHPにFTP関数が実装されていない場合は、まずはこのカスタムFTPを選択します。
      • PHP_FTP（FTPS用）
        • PHPにFTP関数が実装されている場合は、こちらも選択できます。　サーバーがFTPSでの転送をサポートする場合は、これを選択して、次項でSSL(FTPS)を設定します。
      • カスタムSSH_FTP
        • サーバーがSSHの使用をサポートしている場合、標準のカスタムFTPよりもこちらの方が高速に動作する場合があります。SSH接続のポート番号が必要です。
      • カスタムSSH2（鍵認証用）
        • サーバーがSSHの鍵認証をサポートしている場合、標準のカスタムFTPよりもこちらの方が高速に動作する場合があります。SSH接続のポート番号と、SSH鍵認証接続場合にprivate_keyが必要です。

  • SSL(FTPS)を使用する

  • 前項で「PHP_FTP（FTPS用）」を指定した場合に、SSL(FTPS)が使用可能です。

  • FTPログインID／FTPログインパスワード

  • ご使用のサーバーの、FTPログインIDとパスワードを入力します。

  • SSH接続のポート

  • SSH_FTP接続、または鍵認証接続の場合にSSHポート番号を指定します。defaultは22。

  • SSH鍵認証接続のprivate_key

  • SSH鍵認証接続場合にprivate_keyが必要です。セキュリティ上、private_keyをサーバーに保存しておくのは危険なので、作業開始前に入力し、作業完了後に消去しておくことを強くお勧めします。

  • デバグ出力を表示する

  • 問題が解決しない場合は、ここを「はい」とすることで、追加デバグ情報が表示されます。

  • テーマURL

  • CMS Theme Finder のURLです。通常は変更不要です。

  • アドオンストアURL

  • アドオンストアデータ取得用の URL です。通常は変更不要です。

  • 非表示にされたストアも表示する *アドオンストアで、非表示に設定されているストアも表示します。通常、非表示にされているストアには、開発者用のストアが含まれています。

  • ストアデータ取得時の同時接続数

  • ストア一覧のデータを取得する場合の HTTP 同時接続数を設定します。環境によりデータ取得に失敗する場合はこの値を減らして調整します。（デフォルト： 50）

  • curl_multi_select を使用しない

  • 環境により同時接続数を 2 以上にするとデータ取得に失敗する場合があります。その場合に限り「はい」を選択してください。

  • cURL: SSLホスト認証をしない

  • cURL 利用時に SSL接続時のサーバー認証がエラーになる場合に「はい」を選択してください。

インストール操作

操作の流れに従っていればわかると思いますが、以下のサイトなどを参考にしてみてください。