メインコンテンツまでスキップ
バージョン: 開発中

WEB Get server info

WEB Get server info {( withCache )} -> 戻り値

引数説明
withCacheブール🡒Webキャッシュ詳細を返すためにはTrue、それ以外の場合(デフォルト)ではキャッシュ詳細は返されない
戻り値オブジェクト🡐実行中のWebサーバーとSOAPサーバーの情報

説明

WEB Get server info コマンドは、4D Web サーバーのカレントのセッションの詳細なランタイム情報を格納したオブジェクトを返します。返された情報にはSOPA サーバーのものも含まれます。

注: このコマンドはランタイムの情報、つまりWeb サーバーで実際に使われているパラメーターを返します。これらのパラメーターは、WEB GET OPTION コマンドで返されたものとは異なる可能性があります。なぜならシステム設定や利用可能なリソースによって変化するためです。

デフォルトでは、コマンドは"cache"プロパティを返しません。そのサイズが大きくなりうるためです。しかしながら、キャッシュの中身を知りたい場合には、任意のwithCache 引数にTrueを渡して下さい。

返されたオブジェクトには以下のプロパティが含まれます(プロパティ名は大文字と小文字を区別します):

プロパティ名値の型詳細
startedブールhttpサーバーが開始されていればTrue、そうでなければFalse
uptime数値httpサーバーが最後に開始されてからの経過時間
httpRequestCount数値サーバーが開始されてからのhttpヒットの回数
startMode文字列"開始時にWebサーバーを開始"がチェックされていれば"automatic"、それ以外は"manual"
SOAPServerStartedブールSOAPサーバーが開始されていればTrue、そうでなければFalse
cacheオブジェクトこのプロパティは withCache *引数のプロパティ値がTrueであった場合のみ含まれます。Web サーバーキャッシュの中身の情報です(以下のcacheプロパティ を参照して下さい)。
securityオブジェクト様々なセキュリティのオプションについてのカレントの状態
cipherSuite文字列4Dが安全なプロトコルに使用している暗号化リスト(SSL cipher list のデータベースパラメーターに対応します)
HTTPEnabledブールHTTP が有効化されている場合にはTrue
HTTPSEnabledブールHTTPS が有効化されている場合にはTrue
HSTSEnabledブールHSTS がサーバーで有効化されている場合にはTrue
HSTSMaxAge数値HSTS の最大年数(秒単位)。デフォルトは2年(63,072,000 秒)です。
minTLSVersion文字列接続を受け入れる最低限のTLSバージョン(Min TLS version のデータベースパラメーターに対応します)
openSSLVersion文字列使用されているOpenSSL ライブラリのバージョン
perfectForwardSecrecyブールPFSがサーバーで利用可能であればTrue、それ以外の場合にはFalse
optionsオブジェクト様々な標準のWebサーバーオプションについてのカレントの状態
CORSEnabledブールCORS サービスがサーバーで有効化されていればTrue、それ以外の場合にはFalse(デフォルト)
CORSSettingsコレクション許可されたホストとメソッドの一覧を定義するCORS オブジェクトのコレクション(Web CORS settings のweb optionを参照)
webCharacterSet文字列文字セット名(Web character set Web オプションに対応します)
webHTTPCompressionLevel数値圧縮HTTP交換での圧縮レベル(Web HTTP compression level Web オプションに対応します)
webHTTPCompressionThreshold数値圧縮のスレッショルド(Web HTTP compression threshold Web オプションに対応します)
webHTTPSPortID数値Web サーバーによって安全な接続に使用されるTCP ポート番号(Web HTTPS port ID Web オプションに対応します)
webInactiveProcessTimeout数値スケーラブルWeb セッションでは特に意味を持ちません、 **Webセッション管理(旧式) を参照してください。**アクティブでないセッションプロセスの保持時間(Web inactive session timeout Web オプションに対応します)
webInactiveSessionTimeout数値****スケーラブルWeb セッションでは特に意味を持ちません、 Webセッション管理(旧式) を参照してください。**アクティブでないセッションの保持時間(Web inactive session timeout Web オプションに対応します)
webIPAddressToListenコレクションWeb サーバーがhttp リクエストを受け付ける、定義された"フォーマット"になっているIPアドレス(Web IP address to listen Web オプションに対応します)
webMaxConcurrentProcesses数値****スケーラブルWeb セッションでは特に意味を持ちません、 Webセッション管理(旧式) を参照してください。**同Web プロセスの最大同時接続数(Web max concurrent processes Web オプションに対応します)。
webPortIDNumberWeb サーバーが使用するTCP ポート番号(Web port ID Web オプションに対応します)

4D Server: コマンドはローカルのWeb サーバーについての情報を返します。4D Server のWeb サーバーをリモートからモニターしたい場合にはメソッドの"サーバーで実行"プロパティを適用する必要があります。

cacheプロパティ

withCache 引数にtrue を渡した場合、コマンドは以下の中身を格納した"cache" オブジェクトプロパティを返します:

プロパティ名値の型詳細
cacheUsageNumberキャッシュ使用率
numOfLoadsNumber読み込んだオブジェクトの数
currentSizeNumberキャッシュのカレントのサイズ
maxSizeNumberキャッシュの最大サイ
objectMaxSizeNumberキャッシュ内に読み込み可能なオブジェクトの最大数
enabledBooleanWeb サーバーキャッシュが有効化されている場合にはtrue
nbCachedObjectsNumberキャッシュ内のオブジェクトの数
cachedObjectsCollectionキャッシュ内のオブジェクトのコレクション。それぞれのキャッシュされたオブジェクトは異なるプロパティ(url、mimeType、expirationType、lastModified、等)によって定義されています。

例題

以下のコードを実行した場合:

 $webServerInfo:=WEB Get server info(True)

... $webServerInfo の中身は、一例として、以下のようになります:

{   "started": true,   "uptime": 40,   "SOAPServerStarted": true,   "startMode": "manual",   "httpRequestCount": 0,   "options": {      "CORSEnabled": false,      "CORSSettings": null,      "webCharacterSet": "UTF-8",      "webHTTPCompressionLevel": 1,      "webHTTPCompressionThreshold": 1024,      "webHTTPSPortID": 443,      "webIPAddressToListen": ["192.168.xxx.xxx"],      "webInactiveProcessTimeout": 28800,      "webInactiveSessionTimeout": 28800,      "webMaxConcurrentProcesses": 100,      "webPortID": 80   },   "security": {      "HTTPEnabled": true,      "cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256:...:CAMELLIA128-SHA",      "openSSLVersion": "OpenSSL 1.0.2h 3 May 2016",      "perfectForwardSecrecy": true,      "minTLSVersion": "1.2"    },    "cache": {        "cacheUsage": 1,        "numOfLoads": 24,        "currentSize": 154219,        "maxSize": 10485760,        "objectMaxSize": 524288,        "enabled": true,        "nbCachedObjects": 23,        "cachedObjects": [            {...},{...}         ]   }}

参照

Get license info
Get process activity
SOAP REJECT NEW REQUESTS