{"id":19326123,"url":"https://github.com/bartko-s/stefano-nested-transaction","last_synced_at":"2025-04-22T20:32:31.247Z","repository":{"id":13413764,"uuid":"16102301","full_name":"bartko-s/stefano-nested-transaction","owner":"bartko-s","description":"PHP library which manage nested database transactions","archived":false,"fork":false,"pushed_at":"2022-09-30T19:56:39.000Z","size":12,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-07-13T09:51:04.837Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bartko-s.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-01-21T12:49:08.000Z","updated_at":"2022-09-30T19:04:56.000Z","dependencies_parsed_at":"2022-09-24T04:01:26.329Z","dependency_job_id":null,"html_url":"https://github.com/bartko-s/stefano-nested-transaction","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bartko-s%2Fstefano-nested-transaction","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bartko-s%2Fstefano-nested-transaction/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bartko-s%2Fstefano-nested-transaction/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bartko-s%2Fstefano-nested-transaction/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bartko-s","download_url":"https://codeload.github.com/bartko-s/stefano-nested-transaction/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223903480,"owners_count":17222551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T02:12:32.012Z","updated_at":"2024-11-10T02:12:32.734Z","avatar_url":"https://github.com/bartko-s.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Stefano Nested Transaction\r\n===================\r\n\r\n[![Build Status](https://app.travis-ci.com/bartko-s/stefano-nested-transaction.svg?branch=master)](https://app.travis-ci.com/bartko-s/stefano-nested-transaction)\r\n[![Coverage Status](https://coveralls.io/repos/bartko-s/stefano-nested-transaction/badge.png?branch=master)](https://coveralls.io/r/bartko-s/stefano-nested-transaction?branch=master)\r\n\r\nInstalation using Composer\r\n--------------------------\r\n1. Run command  ``` composer require stefano/stefano-nested-transaction```\r\n\r\nFeatures\r\n------------\r\n\r\n- manages nested transaction\r\n\r\nUsage\r\n------\r\n\r\n- Configuration\r\n\r\n```\r\n//$transactionAdapter implements \\StefanoNestedTransaction\\Adapter\\TransactionInterface\r\n$transactionAdapter = new YourTransactionAdapter();\r\n\r\n$transactionManager = new \\StefanoNestedTransaction\\TransactionManager($transactionAdapter);\r\n```\r\n\r\n- Example: normal flow\r\n\r\n```\r\n$transactionManager-\u003ebegin(); //REAL start transaction\r\ntry {\r\n    // ...\r\n\r\n    //nested transaction block, that might be in some other code\r\n    $transactionManager-\u003ebegin(); //increase internal transaction counter\r\n    try {\r\n        // ...\r\n\r\n        $transactionManager-\u003ecommit(); //decrease internal transaction counter\r\n    } catch(\\Exception $e) {\r\n        $transactionManager-\u003erollback(); //skipped\r\n        throw $e-\u003egetPrevious();\r\n    }\r\n\r\n    // ...\r\n    $transactionManager-\u003ecommit(); //REAL commit transaction;\r\n} catch(\\Exception $e) {\r\n    $transactionManager-\u003erollback(); //skipped\r\n    throw $e-\u003egetPrevious();\r\n}\r\n```\r\n\r\n- Example: throw exception\r\n\r\n```\r\n$transactionManager-\u003ebegin(); //REAL start transaction\r\ntry {\r\n    // ...\r\n\r\n    //nested transaction block, that might be in some other code\r\n    $transactionManager-\u003ebegin(); //increase internal transaction counter\r\n    try {\r\n        // ...\r\n\r\n        throw new \\Exception();\r\n\r\n        $transactionManager-\u003ecommit(); //skipped\r\n    } catch(\\Exception $e) {\r\n        $transactionManager-\u003erollback(); //marked as rollback only\r\n        throw $e-\u003egetPrevious();\r\n    }\r\n\r\n    // ...\r\n    $transactionManager-\u003ecommit(); //skipped\r\n} catch(\\Exception $e) {\r\n    $transactionManager-\u003erollback(); //REAL rollback\r\n    throw $e-\u003egetPrevious();\r\n}\r\n```\r\n\r\n- Example: throw exception\r\n\r\n```\r\n$transactionManager-\u003ebegin(); //REAL start transaction\r\ntry {\r\n    // ...\r\n\r\n    //nested transaction block, that might be in some other code\r\n    $transactionManager-\u003ebegin(); //increase internal transaction counter\r\n    try {\r\n        // ...\r\n\r\n        throw new \\Exception();\r\n\r\n        $transactionManager-\u003ecommit(); //do nothing\r\n    } catch(\\Exception $e) {\r\n        $transactionManager-\u003erollback(); //marked as rollback only\r\n    }\r\n\r\n    // ...\r\n    $transactionManager-\u003ecommit(); //this throw exception because transaction is marked as rollback only\r\n} catch(\\Exception $e) {\r\n    $transactionManager-\u003erollback(); //REAL rollback\r\n    throw $e-\u003egetPrevious();\r\n}\r\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbartko-s%2Fstefano-nested-transaction","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbartko-s%2Fstefano-nested-transaction","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbartko-s%2Fstefano-nested-transaction/lists"}