Documentation Home
MySQL PHP API
Download this Manual
PDF (US Ltr) - 2.4Mb
PDF (A4) - 2.4Mb
HTML Download (TGZ) - 250.0Kb
HTML Download (Zip) - 257.5Kb


MySQL PHP API  /  ...  /  TableSelect::lockShared

5.33.8 TableSelect::lockShared

Copyright 1997-2019 the PHP Documentation Group.

  • TableSelect::lockShared

    Execute SHARED LOCK

Description

public mysql_xdevapi\TableSelect mysql_xdevapi\TableSelect::lockShared(integer lock_waiting_option);

Execute a read operation with SHARED LOCK. Only one lock can be active at a time.

Parameters

lock_waiting_option

The optional waiting option that defaults to MYSQLX_LOCK_DEFAULT. Valid values are:

  • MYSQLX_LOCK_DEFAULT

  • MYSQLX_LOCK_NOWAIT

  • MYSQLX_LOCK_SKIP_LOCKED

Return Values

A TableSelect object.

Examples

Example 5.176 mysql_xdevapi\TableSelect::lockShared example

<?php
$session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");

$schema = $session->getSchema("addressbook");
$table  = $schema->getTable("names");

$session->startTransaction();

$result = $table->select('name', 'age')
  ->lockShared(MYSQLX_LOCK_NOWAIT)
  ->execute();

$session->commit();

$row = $result->fetchAll();
print_r($row);
?>

The above example will output something similar to:


Array
(
    [0] => Array
        (
            [name] => John
            [age] => 42
        )
    [1] => Array
        (
            [name] => Sam
            [age] => 42
        )
)