Files
Leonardo Lara Rodrigues 4baf074b52 sync file lines with en rev
2026-01-27 09:14:27 -03:00

66 lines
2.5 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f0edac3006cc81cc9cd06fd21d4f4bdc244e10c9 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.sync">
<?phpdoc extension-membership="pecl" ?>
<title>Sync</title>
<titleabbrev>Sync</titleabbrev>
<preface xml:id="intro.sync">
&reftitle.intro;
<simpara>
A extensão <literal>sync</literal> introduz objetos de sincronização multiplataforma no PHP.
Objetos de Mutex, Semaphore, Event, Reader-Writer e Shared Memory nomeados e não nomeados
fornecem sincronização em nível de sistema operacional em plataformas POSIX (por exemplo, Linux)
e Windows.
</simpara>
<simpara>
A limpeza automática de objetos de sincronização adquiridos ocorre durante a desmontagem
da extensão. Isso significa que se o PHP encerrar prematuramente um script (por exemplo,
o tempo de execução do script for excedido), os objetos não serão deixados em um estado desconhecido. A
única exceção a isso é se o próprio PHP travar (por exemplo, uma sobrecarga de buffer interna).
</simpara>
<simpara>
Objetos de sincronização não nomeados não têm muita utilidade fora de um cenário
multithread. Objetos não nomeados são mais úteis em conjunto com a extensão pthreads
do PECL.
</simpara>
<note>
<simpara>
Objetos nomeados requerem cuidados adicionais para serem usados em todos os sistemas.
Se um objeto for instanciado com um conjunto específico de parâmetros, ele sempre deve
ser instanciado com esses parâmetros, caso contrário, o objeto provavelmente acabará em um
estado inconsistente até a próxima reinicialização ou até que um administrador de sistema limpe
a bagunça.
</simpara>
</note>
</preface>
&reference.sync.setup;
&reference.sync.syncmutex;
&reference.sync.syncsemaphore;
&reference.sync.syncevent;
&reference.sync.syncreaderwriter;
&reference.sync.syncsharedmemory;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->