Download the PHP package vihaya/events without Composer

Vihaya SDK for PHP — Official vihaya/events Composer Package

vihaya/events is the official PHP SDK for the Vihaya Events platform. Build event listings, attendee registration flows, Razorpay payment verification, ticketing dashboards, Laravel apps, Symfony bundles, WordPress plugins, Drupal modules, Magento extensions, and any PHP 8.1+ backend — all with type-safe readonly models and forward-compatible parsing.

Vihaya is the modern events platform for India — a single stack for event organisers, ticketing, sponsor management, attendee registration, live check-in, and real-time analytics. This package is the fastest way to integrate the Vihaya Events API (https://events.vihaya.app) into any PHP codebase.

Table of contents

• What is Vihaya?
• Why the Vihaya PHP SDK?
• The Vihaya SDK family
• Requirements
• Installation
• Get your Vihaya API key
• Quick start
• Configuration
• Core concepts
• Usage guide
• Framework integrations
• Mega events & sub-events
• Razorpay payment flow
• API reference
• Models
• Error handling
• Security best practices
• FAQ
• Keywords
• Development
• Contributing
• License

🇮🇳 What is Vihaya?

Vihaya is an all-in-one events platform for India, built for organisers who run college fests, hackathons, conferences, workshops, meetups, bootcamps, summits, and corporate events. The Vihaya platform provides:

• 🎟️ Event creation & ticketing with pricing tiers, promo codes, and a hosted checkout.
• 🏢 Mega events — bundle dozens of sub-events under one parent fest.
• 💳 Razorpay payments — end-to-end with server-side signature verification.
• 📋 Custom registration fields — T-shirt size, college, team members, dietary preferences, accommodation.
• 👥 Attendee management — real-time registrations, broadcasts, CSV exports.
• 📱 Live check-in with mobile QR scanning.
• 👩‍🏫 Speakers, agenda, sponsors, FAQs.
• 📊 Analytics — registrations, revenue, funnel tracking.

This vihaya/events Composer package lets PHP developers embed the Vihaya Events API into Laravel apps, Symfony bundles, WordPress plugins, Drupal modules, Magento 2 extensions, Slim micro-services, CodeIgniter projects, Yii apps, CakePHP apps, and standalone PHP scripts.

Production URL: https://events.vihaya.app · Marketing site: https://vihaya.app · Developer dashboard: https://events.vihaya.app/profile/developer

✨ Why the Vihaya PHP SDK?

• 🔐 Modern PHP — final readonly model classes (PHP 8.2 features), strict types, named arguments.
• 🧪 Tested — PHPUnit 10 suite with Guzzle MockHandler. 11 tests, 32 assertions, fully offline.
• 📦 Slim — only guzzlehttp/guzzle and ext-json as dependencies.
• 🔄 Forward compatible — every model preserves unknown fields on $model->raw, so the SDK survives API additions without a release.
• 🧩 PSR-friendly — accepts a Psr\Http\Client\ClientInterface for custom HTTP middleware (logging, tracing, retries).
• 🎯 Strict typing — every method signature is fully typed; PHPStan level 6 clean.
• 💳 Razorpay ready — $vihaya->events()->register() → Razorpay → $vihaya->payments()->verify().

🌍 The Vihaya SDK family (7 languages)

All Vihaya SDKs target the same API base URL (https://events.vihaya.app), authenticate with the same x-api-key header, and expose the same methods.

📋 Requirements

• PHP 8.1, 8.2, 8.3, 8.4+
• ext-json
• guzzlehttp/guzzle ^7.5 (pulled in automatically)

📦 Installation

Then load Composer's autoloader:

Package name: vihaya/events on Packagist. PHP namespace: Vihaya\Events.

🔑 Get your Vihaya API key

1. Sign up or log in at events.vihaya.app.
2. Open the Developer Dashboard.
3. Click Generate API Key and copy the vh_live_... token.
4. Store it in .env, environment variables, or a secrets manager — never commit it to git.

🚀 Quick start

⚙️ Configuration

🧭 Core concepts

• Events — the root record. Title, description, date, venue, tiers, custom fields, speakers, agenda, sponsors, FAQs, sub-events.
• Mega events — parent events containing sub-events. Access via $event->subEvents.
• Registrations — free or paid attendee entries with optional custom fields and team members.
• Payments — Razorpay orders created during events()->register(), verified via payments()->verify().
• API key — vh_live_... token from the developer dashboard.

📚 Usage guide

Fetch a full event

List & filter events

Register with tiers, promo codes, and custom fields

Register a hackathon team

You can pass a plain array instead of RegisterData — use camelCase keys (teamMembers, customFields, paymentId) on that path.

🎨 Framework integrations

Laravel

Symfony

WordPress plugin

Slim micro-framework

🏢 Mega events & sub-events

💳 Razorpay payment flow

1. Backend — $vihaya->events()->register($id, $data) → Vihaya creates a Razorpay order and returns orderId.
2. Frontend — launch Razorpay Checkout with that order ID.
3. Razorpay callback — hands back razorpay_payment_id, razorpay_order_id, razorpay_signature.
4. Backend — $vihaya->payments()->verify(...) confirms the signature and marks the registration paid.

⚠️ Always verify payments on the server. Never trust a signature checked only in the browser.

📖 API reference

new Vihaya(string $apiKey, ?string $baseUrl = null, array $headers = [], float $timeout = 30.0, ?ClientInterface $httpClient = null)

Construct a client. Get your API key from the developer dashboard.

$vihaya->events()->list(): list<Event>

Returns every event on the authenticated organiser account.

$vihaya->events()->get(string $eventId): Event

Fetches full metadata for one event — agenda, speakers, sponsors, FAQs, pricing tiers, custom fields, venue info, and sub-events for mega events.

$vihaya->events()->register(string $eventId, RegisterData|array $data): array

Registers an attendee. Pass a RegisterData for type safety, or a plain array (camelCase keys). Returns the API response — orderId for paid events, registrationId for free.

$vihaya->payments()->verify(string $paymentId, string $orderId, string $signature, ?float $amount = null): array

Server-side verification of a Razorpay payment signature. Always call from your backend.

🧬 Models

All models are final readonly classes (PHP 8.2+) with a fromArray() factory. Unknown fields are preserved on $model->raw, so the SDK is forward-compatible with new API fields without waiting for a release.

• Event — root event with all metadata
• Speaker — name, role, company, bio, photoUrl
• Sponsor — name, tier, logoUrl, website
• AgendaItem — time, title, description, speaker
• Contact — name, email, phone
• FAQItem — question, answer
• CustomField — name, type, required, options
• SpecialPrice — name, amount, description
• PromoCode — code, discount, discountType
• RegisterData — mutable DTO for the register payload

🚨 Error handling

Every API and transport failure surfaces as VihayaException:

🛡️ Security best practices

Never hard-code a vh_live_... key in client-side JavaScript or front-end PHP templates.

• Use getenv(), $_ENV, Laravel's config()/env(), Symfony's %env()%, Drupal's settings, or a secrets manager.
• Call events()->register() and payments()->verify() from backend code only.
• Always verify Razorpay signatures server-side.
• Rotate keys via the Vihaya developer dashboard if you suspect a leak.
• Use separate keys for staging and production.

❓ FAQ

What is Vihaya?

Vihaya is an events platform for India — ticketing, registrations, payments, check-in, analytics, and attendee management. Platform: vihaya.app. Dashboard: events.vihaya.app.

Does the SDK work with Laravel / Symfony / WordPress / Drupal / Magento?

Yes. It's a plain Composer package with PSR-4 autoloading and zero framework coupling. Drop it into any PHP 8.1+ project.

Why does the test suite use Guzzle's MockHandler?

So composer test runs fully offline — no network, no VCR fixtures, no flakiness. CI is fast and deterministic.

A test asserts 49900 but my response shows 49900.0. Why?

json_encode collapses whole-number floats to integers. The Vihaya server parses both identically, so this is not an SDK bug. Use fractional amounts in tests (e.g., 499.99) or non-strict assertions.

Can I inject my own HTTP client?

Yes — pass anything implementing GuzzleHttp\ClientInterface (or Psr\Http\Client\ClientInterface) as the fifth constructor argument. Useful for adding logging, tracing, retries, or middleware.

Does Vihaya support Razorpay test mode?

Yes — use a test API key from the Vihaya developer dashboard.

🔎 Keywords

vihaya · vihaya sdk · vihaya php · vihaya php sdk · vihaya events php · vihaya/events · vihaya api php · php events api · laravel vihaya · symfony vihaya · wordpress vihaya plugin · drupal vihaya module · magento vihaya · php ticketing sdk · php razorpay events · vihaya razorpay php · events api india php · event management sdk php · composer vihaya · packagist vihaya · events.vihaya.app php · vihaya official php sdk

🛠️ Development

The test suite uses Guzzle's MockHandler and makes no real network calls.

🤝 Contributing

Contributions to the Vihaya PHP SDK are very welcome. The project is open source and MIT-licensed.

1. Fork Vishnu252005/vihaya-sdk-php.
2. Create a feature branch.
3. Run composer test, composer lint, and composer format.
4. Commit, push, and open a Pull Request.

Reporting issues

Found a bug or have a feature request? Open an issue at github.com/Vishnu252005/vihaya-sdk-php/issues.

📄 License

MIT © Vihaya. See LICENSE.

💬 Support

• 📧 Email: [email protected]
• 🌐 Website: vihaya.app
• 🛠️ Dashboard: events.vihaya.app
• 👨‍💻 Developer docs: events.vihaya.app/profile/developer/docs
• 📦 Packagist: packagist.org/packages/vihaya/events
• 🐛 Issues: github.com/Vishnu252005/vihaya-sdk-php/issues

Built with ❤️ by the Vihaya team.

Related Vihaya SDK repositories

• PHP: vihaya-sdk-php — you are here
• JavaScript / TypeScript: vihaya-sdk
• Python: vihaya-sdk-python
• Go: vihaya-sdk-go
• Java: vihaya-sdk-java
• Ruby: vihaya-sdk-ruby
• Flutter: vihaya-sdk-flutter