高度な構成¶

ログを作成する
環境変数
Settings summary
レイヤー、グループ、およびプロジェクトの短い名前
サービスファイルへの接続
お使いのLinuxサーバーにフォントを追加

ログを作成する ¶

To log requests sent to the server, you have to set the following environment variables:

QGIS_SERVER_LOG_LEVEL
QGIS_SERVER_LOG_FILE
QGIS_SERVER_LOG_STDERR

Take a look on 環境変数 to understand their meanings.

環境変数 ¶

You can configure some aspects of QGIS Server by setting environment variables.

According to the HTTP server and how you run QGIS Server, there are several ways to define these variables. This is fully described in HTTPサーバー構成.

QGIS_OPTIONS_PATH¶

Specifies the path to the directory with settings. It works the same way as QGIS application --optionspath option. It is looking for settings file in <QGIS_OPTIONS_PATH>/QGIS/QGIS3.ini.

QUERY_STRING¶

The query string, normally passed by the web server. This variable can be useful while testing QGIS server binary from the command line.

For example for testing a GetCapabilities request on the command line to a project that also requires a PostgreSQL connection defined in a pg_service.conf file:

PGSERVICEFILE=/etc/pg_service.conf QUERY_STRING="MAP=/path/to/test.qgs&SERVICE=WMS&REQUEST=GetCapabilities" /path/to/qgis_mapserv.fcgi

The result should be either the content of the GetCapabilities response or, if something is wrong, an error message.

QGIS_PROJECT_FILE¶

The .qgs or .qgz project file, normally passed as a parameter in the query string (with MAP), you can also set it as an environment variable (for example by using mod_rewrite Apache module).

Note that you may also indicate a project stored in PostgreSQL, e.g. postgresql://localhost:5432?sslmode=disable&dbname=mydb&schema=myschema&project=myproject.

QGIS_SERVER_LOG_FILE¶

Specify path and filename. Make sure that server has proper permissions for writing to file. File should be created automatically, just send some requests to server. If it's not there, check permissions.

QGIS_SERVER_LOG_FILE is deprecated since QGIS 3.4. File logging support will be removed in QGIS 4.0.

QGIS_SERVER_LOG_STDERR¶

Activate logging to stderr. It's disabled by default. This variable has no effect when QGIS_SERVER_LOG_FILE is set.

0 or false (case insensitive)
1 or true (case insensitive)

MAX_CACHE_LAYERS¶

Specify the maximum number of cached layers (default: 100).

DISPLAY¶

This is used to pass (fake) X server display number (needed on Unix-like systems).

QGIS_PLUGINPATH¶

Useful if you are using Python plugins for the server, this sets the folder that is searched for Python plugins.

QGIS_SERVER_LOG_LEVEL¶

Specify desired log level. Available values are:

0 or INFO (log all requests)
1 or WARNING
2 or CRITICAL (log just critical errors, suitable for production purposes)

QGIS_SERVER_PARALLEL_RENDERING¶

Activates parallel rendering for WMS GetMap requests. It's disabled (false) by default. Available values are:

0 or false (case insensitive)
1 or true (case insensitive)

QGIS_SERVER_MAX_THREADS¶

Number of threads to use when parallel rendering is activated. Default value is -1 to use the number of processor cores.

QGIS_SERVER_CACHE_DIRECTORY¶

Specifies the network cache directory on the filesystem. The default directory is named cache and located in the profile directory.

QGIS_SERVER_CACHE_SIZE¶

Sets the network cache size in MB. The default value is 50 MB.

Settings summary ¶

When QGIS Server is starting, you have a summary of all configurable parameters thanks to environment variables. Moreover, the value currently used and the origin is also displayed.

For example with spawn-fcgi:

export QGIS_OPTIONS_PATH=/home/user/.local/share/QGIS/QGIS3/profiles/default/
export QGIS_SERVER_LOG_FILE=/home/user/qserv.log
export QGIS_SERVER_LOG_LEVEL=2
spawn-fcgi -f /usr/lib/cgi-bin/qgis_mapserv.fcgi -s /tmp/qgisserver.sock -U www-data -G www-data -n

 QGIS Server Settings:

   - QGIS_OPTIONS_PATH / '' (Override the default path for user configuration): '/home/user/.local/share/QGIS/QGIS3/profiles/default/' (read from ENVIRONMENT_VARIABLE)

   - QGIS_SERVER_PARALLEL_RENDERING / '/qgis/parallel_rendering' (Activate/Deactivate parallel rendering for WMS getMap request): 'true' (read from INI_FILE)

   - QGIS_SERVER_MAX_THREADS / '/qgis/max_threads' (Number of threads to use when parallel rendering is activated): '4' (read from INI_FILE)

   - QGIS_SERVER_LOG_LEVEL / '' (Log level): '2' (read from ENVIRONMENT_VARIABLE)

   - QGIS_SERVER_LOG_FILE / '' (Log file): '/tmp/qserv.log' (read from ENVIRONMENT_VARIABLE)

   - QGIS_PROJECT_FILE / '' (QGIS project file): '' (read from DEFAULT_VALUE)

   - MAX_CACHE_LAYERS / '' (Specify the maximum number of cached layers): '100' (read from DEFAULT_VALUE)

   - QGIS_SERVER_CACHE_DIRECTORY / '/cache/directory' (Specify the cache directory): '/root/.local/share/QGIS/QGIS3/profiles/default/cache' (read from DEFAULT_VALUE)

   - QGIS_SERVER_CACHE_SIZE / '/cache/size' (Specify the cache size): '52428800' (read from INI_FILE)

 Ini file used to initialize settings: /home/user/.local/share/QGIS/QGIS3/profiles/default/QGIS/QGIS3.ini

In this particular case, we know that QGIS_SERVER_MAX_THREADS and QGIS_SERVER_PARALLEL_RENDERING values are read from the ini file found in QGIS_OPTIONS_PATH directory (which is defined through an environment variable). The corresponding entries in the ini file are /qgis/max_threads and /qgis/parallel_rendering and their values are true and 4 threads.

レイヤー、グループ、およびプロジェクトの短い名前 ¶

要素の数は、 <Name> と <Title> の両方を有します。名は、マシン・ツー・マシンの通信に使用するテキスト文字列で、 タイトル は人間の利益のものです。

例えば、データセットは、説明のタイトル「最高気温」を持っているかもしれないと略称「ATMAX」を使用して要求します。ユーザーはすでにレイヤー、グループやプロジェクトのタイトルを設定できます。

OWS名はレイヤーツリーに使用される名前に基づいています。この名前は、マシン間通信のための名前よりもより人間のためのラベルです。

QGISサーバーがサポートするのは：

レイヤープロパティへの短い名前の行編集　これを変更するには、レイヤーを右クリックして、プロパティ ‣ [メタデータ]タブ ‣ 説明 ‣ 短い名前を選択します。
レイヤーツリーグループへのWMSデータダイアログ（短い名前、タイトル、要約）

レイヤーグループを右クリックし、グループWMS データを設定オプションを選択すると、次のようになります：

グループWMSデータダイアログを設定する¶
プロジェクトプロパティへの短い名前の行編集 - 静的メソッドを介して短い名前の行編集にアクセス可能な正規表現バリデータ 「^[A-Za-z][A-Za-z0-9\._-]*」 を追加します
静的メソッドを介して短い名前のラインエディットにアクセス可能な正規表現のバリデータ 「^[A-ZA-z][A-ZA-Z0-9\._-]*」 を追加します

プロジェクトのプロパティ ‣ OWSサーバー ‣ サービスの機能 ‣ 短い名前の順に選択すると、プロジェクトルートの短い名前を選択できます。
fullProjectSettings に TreeName 要素を追加

短い名前がレイヤー、グループやプロジェクトのために設定されている場合には、レイヤー名としてQGISサーバーによって使用されます。

サービスファイルへの接続 ¶

PostgreSQLのサービス・ファイルのApacheが認識できるようにするために（ PGサービスファイルセクションを参照） *.conf ファイルのようなを見て、確認する必要があり:

SetEnv PGSERVICEFILE /home/web/.pg_service.conf

<Directory "/home/web/apps2/bin/">
  AllowOverride None
.....

お使いのLinuxサーバーにフォントを追加 ¶

他のマシン上のデフォルトでは存在しないかもしれないフォントを指すQGISプロジェクトを使用するかもしれないことに注意してください。これは、プロジェクトを共有する場合（フォントがターゲットマシン上に存在しない場合）、それは他のマシン上で異なって見える可能性があることを意味します。

これが起こらないようにするために、単にターゲットマシン上で不足しているフォントをインストールする必要があります。デスクトップシステム上でこれを行うのは通常は自明です（フォントをダブルクリック）。

Linuxに対しては、デスクトップ環境をインストールしていない（または、コマンドラインを好む）場合、する必要があります：

Debianのベースのシステム:

sudo su
mkdir -p /usr/local/share/fonts/truetype/myfonts && cd /usr/local/share/fonts/truetype/myfonts

# copy the fonts from their location
cp /fonts_location/* .

chown root *
cd .. && fc-cache -f -v

Fedoraのベースのシステム:

sudo su
mkdir /usr/share/fonts/myfonts && cd /usr/share/fonts/myfonts

# copy the fonts from their location
cp /fonts_location/* .

chown root *
cd .. && fc-cache -f -v