# Coroutine\\Channel->push [TOC] 向通道中寫入數據。 ~~~ function Coroutine\Channel->push(mixed $data, float $timeout = -1) : bool; ~~~ ## 參數 * `$data`可以是任意類型的`PHP`變量，包括匿名函數和資源 * 為避免產生歧義，請勿向通道中寫入空數據，如`0`、`false`、空字符串、`null` * `$timeout`設置超時時間，在通道已滿的情況下，`push`會掛起當前協程，在約定的時間內，如果沒有任何消費者消費數據，將發生超時，底層會恢復當前協程，`push`調用立即返回`false`，寫入失敗 > `$timeout`參數在`4.2.12`或更高版本可用 ## 返回值 * 執行成功返回`true` * 通道并關閉時，執行失敗返回`false`，可使用`$chan->errCode`得到錯誤碼 > `channel`基于引用計數實現，是零拷貝的 ## 通道已滿 * 自動`yield`當前協程，其他消費者協程`pop`消費數據后，通道可寫，將重新`resume`當前協程 * 多個生產者協程同時`push`時，底層自動進行排隊，底層會按照順序逐個`resume`這些生產者協程 ## 通道為空 * 自動喚醒其中一個消費者協程 * 多個消費者協程同時`pop`時，底層自動進行排隊，按照順序逐個`resume`這些消費者協程