Wallabagのソースを表示

[[Category:ウェブアプリケーション]]
[[en:Wallabag]]
[https://wallabag.org/ wallabag] は、Web ページを保存するためのセルフホスト可能なアプリケーションです。

== インストール ==

{{Pkg|wallabag}} パッケージをインストールします。

== 設定 ==

=== PHP ===

必要な php モジュールのリストは、[https://doc.wallabag.org/en/admin/installation/requirements.html#php-extensions ここ]にあります。以下のスニペットは簡潔にするために提供されています。

{{hc|/etc/php/conf.d/wallabag.ini|2=
extension=bcmath
extension=gd
extension=gettext
extension=iconv
extension=intl
extension=tidy

; database - sqlite
;extension=pdo_sqlite
;extension=sqlite3

; database - pgsql
;extension=pdo_pgsql
;extension=pgsql
}}

=== Wallabag ===

wallabag が適切に設定されたら、データベースとアプリケーションの状態を初期化するために、コマンドを実行する必要があります。

{{Tip|コマンドに {{ic|1=--env=prod}} を追加して、目的の環境が設定されていることを確認します。}}
{{bc|1=
<nowiki>
# cd /usr/share/wallabag
# sudo -u wallabag php bin/console cache:clear
# sudo -u wallabag php bin/console doctrine:migrations:migrate
</nowiki>
}}

{{Note|{{ic|/etc/wallabag/parameters.yml}} に変更を加えた場合、キャッシュをクリアする必要があります。}}

== データベース ==

サポートされているデータベースは以下の通りです。

* [[SQLite]] (開発専用。本番環境でのデータベースマイグレーションはサポートされていません。)
* [[PostgreSQL]]
* [[MariaDB]]

セットアップや設定方法については、ここでは触れません。

== アプリケーションサーバー ==

=== php-fpm ===

{{ic|/etc/php/php-fpm.d/www.conf}} をコピーして、それを修正することをお勧めします。

{{hc|/etc/php/php-fpm.d/wallabag.conf|2=
[wallabag]

user = wallabag
group = wallabag
}}

== ウェブサーバー ==

=== nginx ===

以下の設定は、アップストリームの[https://doc.wallabag.org/en/admin/installation/virtualhosts.html#configuration-on-nginx ドキュメント]から引用し、少し修正したものです。

{{hc|/etc/nginx/example.conf|2=
<nowiki>
server {
  root /usr/share/wallabag/web;
  
  # When you want to import large files into wallabag, you need to add this line.
  client_max_body_size XM; # allows file uploads up to X megabytes.

  location / {
    # try to serve file directly, fallback to app.php
    try_files $uri /app.php$is_args$args;
  }
  location ~ ^/app\.php(/|$) {
    fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
    fastcgi_split_path_info ^(.+\.php)(/.*)$;
    include fastcgi_params;
    # When you are using symlinks to link the document root to the
    # current version of your application, you should pass the real
    # application path instead of the path to the symlink to PHP
    # FPM.
    # Otherwise, PHP's OPcache may not properly detect changes to
    # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
    # for more information).
    fastcgi_param  SCRIPT_FILENAME  $realpath_root$fastcgi_script_name;
    fastcgi_param DOCUMENT_ROOT $realpath_root;
    # Prevents URIs that include the front controller. This will 404:
    # http://domain.tld/app.php/some-path
    # Remove the internal directive to allow URIs like this
    internal;
  }

  # return 404 for all other php files not matching the front controller
  # this prevents access to other php files you don't want to be accessible.
  location ~ \.php$ {
    return 404;
  }
}
</nowiki>
}}

他のウェブサーバーに関する一般的な設定は、[https://doc.wallabag.org/en/admin/installation/virtualhosts.html 上流]で見つけることができます。

== トラブルシューティング ==

=== バージョン間のアップグレード ===

新旧のバージョンに応じて、アップグレードの[https://doc.wallabag.org/en/admin/upgrade.html 手順]が用意されています。一般に、設定セクションに示すように、キャッシュのクリーニングとデータベースの移行を実行する必要があります。

== 参照 ==

* [https://doc.wallabag.org Wallabag documentation]
* [https://github.com/wallabag/wallabag Source repository]

{{TranslationStatus|Wallabag|2022-08-03|721717}}