Tinker Zero Laravel Package

Getting Started

1. Install the package via Composer: composer require intonate/tinker-zero.
2. Ensure your Laravel Zero application has laravel/tinker installed as a dependency (it’s required by this package).
3. Run php your-app-name tinker from your project root—this will start an interactive REPL session preloaded with your app’s service container, just like php artisan tinker in standard Laravel.
4. The first use case is typically inspecting models or testing Eloquent queries in development: e.g., App\Models\User::first().

Implementation Patterns

• Use in tinker.php config file (auto-discovered) to define startup code—like loading helpers or aliases—for every Tinker session:

  return [
      'startup' => [
          'echo "Welcome to app Tinker!";',
          '$userFactory = fn() => factory(\App\Models\User::class)->make();',
      ],
  ];
  

• Leverage Laravel Zero’s command structure: if you have custom commands, you can test their logic interactively without dispatching jobs or re-running scripts.
• Embed in CI/debug workflows: temporarily add TinkerZero::execute('User::count()'); inside failing command logic for quick introspection (though avoid in production).

Gotchas and Tips

• No autocomplete or history by default—unlike Artisan Tinker, this package does not include readline support out-of-the-box in Laravel Zero. Ensure ext-readline is enabled for a better experience.
• The package is unmaintained as of 2021; verify compatibility with newer Laravel Zero versions (e.g., 8.x/9.x) before adopting in new projects.
• If your app uses custom service providers not auto-loaded in Tinker, manually re-register them in config/tinker.php or app/Console/kernel.php.
• To extend with custom helpers, define a custom tinker.php config and use require_once __DIR__.'/tinker-helpers.php'; in the startup section.
• Debug tip: run php your-app-name tinker --no-ansi if encountering formatting or output corruption in Windows terminals.