Docs don't properly explain how to delete claims

[rbalik]

The documentation says that to delete a message pulled from the queue you just do:
$message->delete();

In reality this fails with a 403. You have to specify the claim ID to properly delete the message. The code that I got working looks like:

$claimId = $message->getClaimIdFromHref();
$message->delete($claimId);

[dgpro]

And it doesn't explain how to release claimed messages at all.
I've found an example in rackspace docs

foreach ($claimedMessages as $claimedMessage) {
   $claimId = $claimedMessage->getClaimIdFromHref();
   $claim   = $queue->getClaim($claimId);
   $claim->delete();
}

but it's seems to be wrong as after the first iteration all claimed messages are released and on the next iteration it will throw these errors:

Fatal error: Uncaught exception 'Guzzle\Http\Exception\ClientErrorResponseException' with message ' in /vendor/guzzle/guzzle/src/Guzzle/Http/Exception/BadResponseException.php on line 43

Guzzle\Http\Exception\ClientErrorResponseException: Client error response [status code] 404 [reason phrase] Not Found [url] https://iad.queues.api.rackspacecloud.com/v1/[removed]/queues/test_events/claims/56f28ccd3cb0301c7412559a in /vendor/guzzle/guzzle/src/Guzzle/Http/Exception/BadResponseException.php on line 43

So apparently you just need to break the loop to release all messages

foreach ($claimedMessages as $claimedMessage) {
   $claimId = $claimedMessage->getClaimIdFromHref();
   $claim   = $queue->getClaim($claimId);
   $claim->delete();
   break;
}

[dmagoo]

Wait, so when you claim a batch of say, 10 messages, if you release one, you have to release all of them? What are you supposed to do if you need to release some, but not all?

For now, this seems to work ok:

$claimId = null;
$deleteClaim = false;
foreach ($claimedMessages as $claimedMessage) {
   $claimId = $claimedMessage->getClaimIdFromHref();

   //process job here
   //if failure happens or for some other reason, you've decided to skip this message for now
   // set $deleteClaim = true;

}

if($claimId !== null && $deleteClaim) {
   $claim   = $queue->getClaim($claimId);
   $claim->delete();
}