array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.proc-nice.php', 1 => 'proc_nice', 2 => '現在のプロセスの優先度を変更する', ), 'up' => array ( 0 => 'ref.exec.php', 1 => 'プログラム実行関数', ), 'prev' => array ( 0 => 'function.proc-get-status.php', 1 => 'proc_get_status', ), 'next' => array ( 0 => 'function.proc-open.php', 1 => 'proc_open', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/exec/functions/proc-nice.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

proc_nice

(PHP 5, PHP 7, PHP 8)

proc_nice — 現在のプロセスの優先度を変更する

説明

proc_nice(int $priority): bool

proc_nice() は、現在のプロセスの優先度を priority で指定された値に変更します。 priority が正数の場合、 現在のプロセスの優先度をより低くし、priority が負数の場合は優先度が上がります。

proc_nice() は、proc_open() やそれに関連する関数とは関係ありません。

パラメータ

priority

新しい優先度の値。この値はプラットフォームによっては異なるかもしれません。

Unix 上では、-20 のように低い値が高い優先度である一方で、 正の値は低い優先度として扱われます。

Windows では、 priority パラメータは次のような意味があります:

優先度クラス 取りうる値
優先度高 priority < -9
通常より高い優先度 priority < -4
通常の優先度 priority < 5 & priority > -5
通常より低い優先度 priority > 5
アイドルな優先度 priority > 9

戻り値

成功した場合に true を、失敗した場合に false を返します。 ユーザーが優先度を変更する権限を持っていないなど、 エラーが発生した場合は E_WARNING レベルのエラーも発行されます。

変更履歴

バージョン 説明
7.2.0 この関数は、Windows で利用できるようになりました。

例

例1 proc_nice() 関数を使い、プロセスの優先度を高に設定する

<?php
// Highest priority
proc_nice(-20);
?>

注意

注意: 可用性

proc_nice() は、使用しているシステムが 'nice' の機能を持っている場合のみ利用可能です。 'nice' は次のシステムに準拠しています: SVr4, SVID EXT, AT&T, X/OPEN, BSD 4.3 。

注意: Windows のみ

proc_nice() 関数は、 PHP がたとえスレッドセーフを有効にしてコンパイルされていたとしても、 現在の プロセス の優先度を変更します。

参考