Influxdb Bundle Laravel Package

Getting Started

This package now requires PHP 7.2+ and Symfony 5.0+, dropping support for older versions (Symfony 2.8, PHP <7.2). Before installation, verify your environment meets these requirements by running:

php -v && composer show symfony/http-foundation

Install via Composer:

composer require vendor/package-name:^3.0.0-beta.1

First Use Case: Test in a non-production environment (e.g., local or testing) due to the beta status. Example:

use Vendor\Package\Service;

$service = new Service();
$response = $service->process(); // Verify core functionality works as expected.

Implementation Patterns

1. Dependency Updates

• Replace symfony/http-foundation (or related Symfony components) with ^5.0 in composer.json:

  "require": {
      "symfony/http-foundation": "^5.0"
  }
  

• Update autoloading if using custom Symfony integrations:

  composer dump-autoload
  

2. Laravel-Specific Workflows

• Service Providers: If the package registers services via Laravel’s ServiceProvider, ensure compatibility with Laravel 8+ (which aligns with Symfony 5.x):

  // config/app.php
  'providers' => [
      Vendor\Package\ServiceProvider::class, // Verify this exists in the package.
  ],
  

• Facades: Check if the package provides facades (e.g., Vendor\Package\Facades\Package). Update usage:

  use Vendor\Package\Facades\Package;
  $result = Package::action(); // Test facade methods.
  

3. Testing Integration

• Beta Testing: Use Laravel’s phpunit.xml to isolate tests:

  <env name="APP_ENV" value="testing"/>
  

• Mocking: For untested package methods, mock dependencies:

  $this->mock(Vendor\Package\UnstableClass::class)->shouldReceive('method')->andReturn(...);
  

Gotchas and Tips

Breaking Changes

1. Symfony 5.0+:

   • HTTP Foundation: Methods like Request::getClientIp() may behave differently. Refer to Symfony’s upgrade guide.
   • Deprecated Features: Remove calls to Symfony 2.8-specific APIs (e.g., Request::getRealMethod()).

2. PHP 7.2+:

   • Type Declarations: The package may now use strict types (string instead of StringInterface). Update your code:

     // Old (PHP <7.2)
     public function setName($name) { ... }
     
     // New (PHP 7.2+)
     public function setName(string $name) { ... }
     

Debugging Beta Issues

• Enable Debug Mode: Laravel’s .env should have:

  APP_DEBUG=true
  

• Log Errors: Use Monolog to capture package-related exceptions:

  Log::error('Package error', ['exception' => $e]);
  

• GitHub Issues: Report bugs to the package’s repo with:
  • Laravel/PHP/Symfony versions.
  • Steps to reproduce.
  • Stack traces (use try-catch to log them).

Extension Points

• Custom Adapters: If the package uses Symfony’s HttpKernel, extend it for Laravel:

  use Symfony\Component\HttpKernel\HttpKernelInterface;
  
  class LaravelAdapter implements HttpKernelInterface {
      // Implement Symfony methods with Laravel equivalents.
  }
  

• Configuration: Check for new config options in config/package.php (if provided).

Production Warning

• Do Not Use in Production: This beta release may introduce:
  • Undocumented behavior changes.
  • Performance regressions.
  • Critical bugs.
• Upgrade Strategy: Wait for 3.0.0-stable or test thoroughly in staging first.