SAMConnection::connect

Establishes a connection to a Messaging Server

&reftitle.description; `bool` `SAMConnection::connect` `string` `protocol` `array` `properties`

Calling the "connect" method on a SAMConnection object connects the PHP script to a messaging server. No messages can be sent or received until a connection is made.

&reftitle.parameters;

&reftitle.returnvalues;

This method returns &false; if an error occurs.

&reftitle.examples;

### Creating a connection to a Messaging Server using the IBM MQSeries protocol (WMQ)

    <?php

    $conn->connect(SAM_WMQ, array(SAM_HOST => 'Myhost.myco.com', SAM_PORT => 1506, SAM_BROKER => 'MyBroker'));

    ?>

### Creating a connection with application transaction control and default host and port values

    <?php

    $conn->connect(SAM_WMQ, array(SAM_BROKER => 'MyBroker', SAM_TRANSACTIONS => SAM_MANUAL));

    ?>

### Creating a connection to a Messaging Server using the IBM WebSphere Platform Messaging protocol (WPM)

    <?php

    $conn->connect(SAM_WPM, array(SAM_ENDPOINTS => 'localhost:7278:BootstrapBasicMessaging',
                                  SAM_BUS => 'Bus1', SAM_TARGETCHAIN => 'InboundBasicMessaging'));

    ?>

&reftitle.seealso;

- samconnection.isconnected
- samconnection.disconnect