Create standard Composer module for GraphRedis library

[Copilot]

This PR implements a complete standard Composer module for the GraphRedis project, transforming it from an empty repository into a fully functional PHP library that provides graph database functionality using Redis as the storage backend.

What's New

Package Structure

• composer.json: Complete package definition with PSR-4 autoloading, dependencies, and metadata
• src/GraphRedis.php: Main library class implementing graph database operations
• tests/GraphRedisTest.php: PHPUnit test suite for basic functionality validation
• phpunit.xml: PHPUnit configuration for running tests

Core Features

The GraphRedis class provides:

• Node Operations: Add, retrieve, and remove nodes with properties
• Edge Operations: Create relationships between nodes with custom properties and relationship types
• Connection Management: Redis connection handling with configurable host/port
• Graph Traversal: Get incoming and outgoing edges for any node

Usage Example

use GraphRedis\GraphRedis;

$graph = new GraphRedis();
$graph->connect('127.0.0.1', 6379);

// Add nodes
$graph->addNode('user1', ['name' => 'John Doe', 'age' => 30]);
$graph->addNode('user2', ['name' => 'Jane Smith', 'age' => 25]);

// Create relationship
$graph->addEdge('user1', 'user2', 'FRIENDS_WITH', ['since' => '2020-01-01']);

// Query the graph
$user1 = $graph->getNode('user1');
$friendships = $graph->getOutgoingEdges('user1');

Technical Details

Standards Compliance

• PSR-4 Autoloading: Proper namespace mapping (GraphRedis\ → src/)
• Composer Best Practices: Semantic versioning, proper dependencies, dev dependencies
• PHP 7.4+ Compatibility: Modern PHP features while maintaining broad compatibility
• Apache 2.0 License: Maintains existing license compatibility

Dependencies

• Runtime: PHP 7.4+, Redis extension
• Development: PHPUnit 9.0 for testing

Project Structure

├── composer.json          # Package definition
├── phpunit.xml            # Test configuration  
├── src/
│   └── GraphRedis.php     # Main library class
├── tests/
│   └── GraphRedisTest.php # Test suite
├── .gitignore             # Updated for PHP/Composer
└── README.md              # Comprehensive documentation

Changes Made

1. Created composer.json with proper package metadata, PSR-4 autoloading, and dependencies
2. Implemented GraphRedis class with full graph database functionality using Redis
3. Added comprehensive test suite using PHPUnit for validation
4. Updated .gitignore from Go-specific to PHP/Composer-appropriate patterns
5. Enhanced README.md with installation instructions, usage examples, and API documentation

The module follows PHP and Composer ecosystem standards, making it ready for distribution via Packagist and integration into other PHP projects.

Validation

• ✅ composer validate passes
• ✅ PSR-4 autoloading works correctly
• ✅ All PHPUnit tests pass (4/4)
• ✅ Class instantiation and basic functionality verified

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/sebastianbergmann/exporter/zipball/78c00df8f170e02473b682df15bfcdacc3d32d72
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/wdW0GR /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/9B4OIQ /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/global-state/zipball/b6781316bdcd28260904e7cc18ec983d0d2ef4f6
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/wdW0GR /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/9B4OIQ /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/5c9eeac41b290a3712d88851518825ad78f45c71
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/wdW0GR /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/9B4OIQ /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/b4f479ebdbf63ac605d183ece17d8d7fe49c15c7
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/wdW0GR /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/9B4OIQ /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/539c6691e0623af6dc6f9c20384c120f963465a0
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/9B4OIQ /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/resource-operations/zipball/05d5692a7993ecccd56a03e40cd7e5b09b1d404e
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/9B4OIQ /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/type/zipball/75e2c2a32f5e0b3aef905b9ed0b179b953b3d7c7
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/9B4OIQ /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/version/zipball/c6c1022351a901512170118436c764e473f6de8c
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/wdW0GR /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/9B4OIQ /usr/bin/composer install --no-interaction (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.