Вызываем Windows API функцию MessageBox из PHP через FFI

Table of contents

Introduction

FFI (Foreign Function Interface) — расширение ЭКСПЕРИМЕНТАЛЬНОЕ. Модуль позволяет загружать общие (shared) библиотеки (.DLL или .so), вызывать функции на языке C и получать доступ к структурам языка C из PHP без необходимости глубоко изучать API модулей Zend и стороннего, «промежуточного» языка.

В PHP >= 7.4.0 появилось новое расширение FFI , с помощью которого можно выйти за рамки привычного PHP и использовать сторонние библиотеки. Познакомимся с этим расширением на примере HelloWorld, который будем выводить в системное окно с помощью Windows API функции MessageBoxA .

MessageBoxA function (winuser.h)

Обратимся к документации по Windows API для того, чтобы понять, как вызывать функцию MessageBoxA .

Видим, что функция принимает 4 параметра:

hWnd ( HWND ) — указатель на окно, которому будет принадлежать создаваемый нами MessageBox . Мы будем передавать NULL , т.е. наш MessageBox не будет иметь владельца.

lpText ( LPCSTR ) — указатель на текст сообщения.

lpCaption ( LPCSTR ) — указатель на текст заголовка сообщения.

uType ( UINT ) — дополнительные параметры окна, которые опишем константами.

Также нам нужно узнать название библиотеки, из которой мы будем вызывать MessageBox. За эту функцию отвечает библиотека User32.dll .

Теперь у нас есть вся информация для вызова MessageBox из PHP -скрипта.

MessageBoxA call from PHP

Зададим имя библиотеки и декларацию функции MessageBox. Вместо LPCSTR используем const char* , а вместо UINT используем int в определении языка C .

Создадим объект FFI:

Вызовем созданную функцию с нужными нам параметрами:

После выполнения скрипта на экране мы увидим MessageBox текстом Hello World. , заголовком окна MessageBox from PHP!, иконкой информации и двумя кнопками OK и CANCEL.

MessageBoxA class

Обернем вызовы и все константы в класс:

MessageBoxA class example

Пример использования описанного выше класса:

На таком простом примере мы показали возможности по работе с системными функциями из PHP -скриптов. PHP FFI позволяет сильно расширить применение PHP , но нужно не забывать, что это экспериментальное расширение. Также стоит отметить, что вызов функций поддерживают декларации на языке С, а не C++, что сужает применимость.

Простой REST API в PHP — Пошаговое руководство

В данной статье вы узнаете, как создать простой REST API в PHP.

• 1. Обзор проекта
• 1.1 Что такое REST API?
• 1.2 Зачем нужен REST API?
• 1.3 Где используется REST API?
• 2. Файловая структура
• 3. Настройка базы данных
• 3.1 Создание таблицы категорий
• 3.2 Дамп данных для таблицы категорий
• 3.3 Создание таблицы товаров
• 3.4 Дамп данных для таблицы товаров
• 3.5 Подключение к базе данных
• 4. Получение товаров
• 4.1 Создание объекта Product
• 4.2 Создание файла для чтения товаров
• 4.3 Подключение к базе данных и таблице товаров
• 4.4 Чтение товаров из базы данных
• 4.5 Создание метода read()
• 4.6 Уведомление пользователя о том, что товары не найдены
• 5. Создание товаров
• 5.1 Создание файла create.php
• 5.2 Создание метода create()
• 6. Получение одного товара
• 6.1 Создание файла read_one.php
• 6.2 Создание метода readOne()
• 7. Обновление товара
• 7.1 Создание файла update.php
• 7.2 Создание метода update()
• 8. Удаление товара
• 8.1 Создание файла delete.php
• 8.2 Создание метода delete()
• 9. Поиск товаров
• 9.1 Создание файла search.php
• 9.2 Создание метода search()
• 10. Пагинация товаров
• 10.1 Создание файла read_paging.php
• 10.2 Создание файла core.php
• 10.3 Создание метода readPaging()
• 10.4 Создание метода count()
• 10.5 Получение массива пагинации
• 11. Получение категорий
• 11.1 Создание объекта Category
• 11.2 Создание файла read.php
• 11.3 Создание метода read()

1. Обзор проекта

1.1 Что такое REST API?

REST — это концепция (архитектура) для организации взаимодействия между независимыми объектами (приложениями) посредством протокола HTTP. Включает в себя набор принципов (рекомендаций) взаимодействия клиент-серверных приложений. Обычно он представлен в формате JSON.

API — интерфейс взаимодействия с каким-либо объектом (программой, приложением), включающий в себя набор правил, которые позволяют одному приложению общаться с другим. Эти «правила» могут включать в себя операции создания, чтения, обновления и удаления. Примером API может служить всем известная библиотека jQuery.

REST API позволяет вашему приложению взаимодействовать с одним или несколькими различными приложениями, используя концепции REST.

1.2 Зачем нужен REST API?

Во многих приложениях REST API необходим, потому что это самый легкий способ создания, чтения, обновления или удаления информации между различными приложениями через Интернет или протокол HTTP. Эта информация представляется пользователю в одно мгновение, особенно если вы используете JavaScript для отображения данных на веб-странице.

1.3 Где используется REST API?

REST API может использоваться любым приложением, которое может подключаться к Интернету. Если данные из приложения могут быть созданы, прочитаны, обновлены или удалены с помощью другого приложения, это обычно означает, что используется REST API.

2. Файловая структура

• api/
  • config/
    • core.php
    • database.php
  • objects/
    • product.php
    • category.php
  • product/
    • create.php/
    • delete.php/
    • read.php/
    • read_paging.php/
    • read_one.php/
    • update.php/
    • search.php/
  • category/
    • read.php
  • shared/
    • utilities.php

3. Настройка базы данных

Используя PhpMyAdmin, создайте новую базу данных api_db . После этого выполните следующие SQL-запросы, чтобы создать новые таблицы с образцами данных.

3.1 Создание таблицы категорий

3.2 Дамп данных для таблицы категорий

3.3 Создание таблицы товаров

3.4 Дамп данных для таблицы товаров

3.5 Подключение к базе данных

Приведенный ниже код показывает учетные данные базы данных и метод для получения подключения к базе данных с помощью PDO.

Создайте папку api и откройте её. Создайте папку config и в ней создайте файл database.php со следующим кодом.

4. Получение товаров

4.1 Создание объекта Product

Код ниже содержит класс с именем Product и несколько свойств. Также показан метод конструктора, который принимает соединение с базой данных.

Мы будем использовать этот класс для чтения данных из базы. Откройте папку API . Создайте папку objects . Откройте папку её и создайте файл product.php . Поместите в него следующий код.

4.2 Создание файла для чтения товаров

Код ниже содержит заголовки о том, кто может читать этот файл и какой тип содержимого он будет возвращать.

В данном случае наш файл read.php может быть прочитан кем угодно (звездочка * означает все) и вернет данные в формате JSON .

Откройте папку API . Создайте в ней папку product . Откройте её и создайте файл read.php со следующим кодом.

4.3 Подключение к базе данных и таблице товаров

В приведенном ниже коде мы подключаем файлы database.php и product.php . Это файлы, которые мы создали ранее.

Нам нужно использовать метод getConnection() класса Database для получения соединения с базой данных. Мы передаем это подключение классу Product .

Замените комментарий // подключение к базе данных будет здесь в файле read.php следующим кодом.

4.4 Чтение товаров из базы данных

В приведенном ниже коде мы используем метод read() класса Product для чтения данных из базы. Через переменную $num мы проверяем, найдены ли записи.

Если найдены записи, мы перебираем их с помощью цикла while , добавляем каждую запись в массив $products_arr , устанавливаем код ответа 200 OK и показываем его пользователю в формате JSON.

Замените комментарий // чтение товаров будет здесь в файле read.php следующим кодом.

4.5 Создание метода read()

Мы использовали метод read() в предыдущем разделе, но он пока ещё не существует в классе Product . Нам нужно добавить этот метод. С помощью кода ниже, мы делаем запрос для получения записей из базы данных.

Откройте папку objects . Откройте файл product.php . Поместите следующий код в класс Product перед последней закрывающей фигурной скобкой вместо комментария // здесь будет метод read() .

4.6 Уведомление пользователя о том, что товары не найдены

Если переменная $num имеет нулевое или отрицательное значение, это означает, что из базы данных не возвращено никаких записей. Мы должны сообщить пользователю об этом.

В приведенном ниже коде мы устанавливаем код ответа 404 — Не найдено и сообщение, что Товары не найдены .

Замените комментарий // ‘товары не найдены’ будет здесь в файле read.php следующим кодом.

5. Создание товаров

5.1 Создание файла create.php

Откройте папку product и создайте в ней файл create.php со следующим содержимым.

5.2 Создание метода create()

Откройте папку objects . Откройте файл product.php и добавьте следующий код внутри класса Product (objects / product.php).

6. Получение одного товара

6.1 Создание файла read_one.php

Откройте папку product , создайте в ней файл read_one.php со следующим содержимым.

6.2 Создание метода readOne()

Откройте папку objects . Откройте файл product.php и добавьте следующий код внутри класса Product .

7. Обновление товара

7.1 Создание файла update.php

Откройте папку product , создайте в ней файл update.php и поместите в него следующий код.

7.2 Создание метода update()

В папке objects откройте файл product.php и добавьте новый метод update() внутри класса Product .

8. Удаление товара

8.1 Создание файла delete.php

Откройте папку product и создайте файл delete.php со следующим содержимым.

8.2 Создание метода delete()

В папке objects откройте файл product.php и добавьте новый метод в класс Product .

9. Поиск товаров

9.1 Создание файла search.php

В папке product создайте файл search.php со следующим кодом.

9.2 Создание метода search()

В папке objects откройте product.php и добавьте метод search() .

10. Пагинация товаров

10.1 Создание файла read_paging.php

В папке product создайте файл read_paging.php со следующим кодом.

10.2 Создание файла core.php

Этот файл содержит нашу базовую конфигурацию, такую как базовый URL и переменные пагинации.

Откройте папку config и создайте в ней файл core.php со следующим содержимым.

10.3 Создание метода readPaging()

В папке objects откройте файл product.php и добавьте метод readPaging() . Этот метод вернет список записей, ограниченный тем, что мы установили в $records_per_page фале core.php .

10.4 Создание метода count()

Так же в классе Product (файл product.php) добавьте метод count() для создания массива пагинации.

10.5 Получение массива пагинации

В корне создайте папку shared , в ней файл utilities.php со следующим кодом.

11. Получение категорий

11.1 Создание объекта Category

Откройте папку objects и создайте новый файл category.php со следующим кодом.

11.2 Создание файла read.php

Создайте новую папку category в корне, и в ней файл read.php со следующим кодом.

11.3 Создание метода read()

Откройте в папке objects файл category.php и создайте метод read() для класса Category .

Frontend часть данного приложения (продолжение) — jQuery + AJAX + JSON.

Если вам понравилась данная статья, рекомендую к прочтению создание регистрации и авторизации в php с использованием JWT.

Надеюсь, вам понравилась данная информация. Если вам интересна тема web-разработки, то можете следить за выходом новых статей в Telegram.

Управление win приложением средствами PHP

Коллеги, прошу помощи!
Стоит задача управлять оконным win приложением (нажатие кнопок и ввод данных в формы) через веб-сайт средствами PHP. Естественно приложение лежит на сервере и есть все необходимые права.

Понимаю, что это несколько извращённая задача, но таковы внешние условия и поменять их возможности нет.

Можете подсказать, как к задаче подойти и какие мануалы курить? Гугление внятных результатов не дало. С консольными приложениями есть варианты, а с окнами как работать — непонятно.

• Вопрос задан более трёх лет назад
• 3273 просмотра

Далее — любым способом приделываем к ПХП: либо расширением, либо просто отдельным приложением с нтерфейсом на stdin/out (пхп его запускает и передает необходимые данные/команды).

Разработчики winamp озаботились об обработке сообщений окна, как то происходит в любом GUI приложении. Любое взаимодействие (манипуляции с окном, клики, нажатие кнопки, и т.д.) — есть сообщение (message) в оконную функцию. Для понимания посмотрите хотя бы пару примеров Чарльза Петцольда (Charles Petzold). А лучше книжку почитать.

Декомпилировать тоже ничего не нужно, достаточно подсмотреть для FindWindow классы главного и дочернего окна например с помощью Spy++ из комплекта визуалстудии (в 6.0 точно было такое добро, дальше — не уверен). Ну а оконные сообщения все стандартные и документированные в MSDN.

Пишем свой API для сайта с использованием Apache, PHP и MySQL

С чего все началось

Разрабатывая проект, я столкнулся с необходимостью организации клиент-серверного взаимодействия приложений на платформах iOS и Android с моим сайтом на котором хранилась вся информация — собственно БД на mysql, картинки, файлы и другой контент.
Задачи которые нужно было решать — достаточно простые:
регистрация/авторизация пользователя;
отправка/получение неких данных (например список товаров).

И тут-то мне захотелось написать свой API для взаимодействия с серверной стороной — большей своей частью для практического интереса.

Входные данные

В своем распоряжении я имел:
Сервер — Apache, PHP 5.0, MySQL 5.0
Клиент — Android, iOS устройства, любой браузер

Я решил, что для запросов к серверу и ответов от него буду использовать JSON формат данных — за его простоту и нативную поддержку в PHP и Android. Здесь меня огорчила iOS — у нее нет нативной поддержки JSON (тут пришлось использовать стороннюю разработку).

Так же было принято решение, что запросы можно будет отсылать как через GET так и через POST запросы (здесь помог $_REQUEST в PHP). Такое решение позволило проводить тестирование API через GET запросы в любом доступном браузере.

Внешний вид запросов решено было сделать таким:
http://[адрес сервера]/[путь к папке api]/?[название_api].[название_метода]=[JSON вида <«Hello»:«Hello world»>]

Путь к папке api — каталог на который нужно делать запросы, в корне которого лежит файл index.php — он и отвечает за вызов функций и обработку ошибок
Название api — для удобства я решил разделить API группы — пользователь, база данных, конент и тд. В таком случае каждый api получил свое название
Название метода — имя метода который нужно вызвать в указанном api
JSON — строковое представление JSON объекта для параметров метода

Скелет API

Скелет API на серверной стороне состоит из нескольких базовых классов:
index.php — индексный файл каталога в Apache на него приходятся все вызовы API, он осуществляет парсинг параметров и вызов API методов
MySQLiWorker — класс-одиночка для работы с базой MySQL через MySQLi
apiBaseCalss.php — родительский класс для всех API в системе — каждый API должен быть наследован от этого класса для корректной работы
apiEngine.php — основной класс системы — осуществляет разбор переданных параметров (после их предварительного парсинга в index.php) подключение нужного класса api (через require_once метод), вызов в нем нужного метода и возврат результата в JSON формате
apiConstants.php — класс с константами для api вызовов и передачи ошибок
apitest.php — тестовый api для тестирования новых методов перед их включением в продакшн версию

Весь механизм выглядит следующим образом:
Мы делаем запрос на сервер — к примеру www.example.com/api/?apitest.helloWorld=<>
На серверной стороне файл index.php — производит парсинг переданных параметров. Index.php берет всегда только первый элемент из списка переданных параметров $_REQUEST — это значит что конструкция вида www.example.com/api/?apitest.helloWorld=<>&apitest.helloWorld2 — произведет вызов только метода helloWorld в apitest. Вызова же метода helloWorld2 непроизойдет

Теперь подробней о каждом

Я попробовал достаточно документировать файлы, чтобы не занимать много место под текст. Однако в тех файлах где нет комментариев, я все ж приведу описание.

Index.php

Как уже говорил раньше это входной индексный файл для Apache а значит все вызовы вида www.example.com/api будет принимать он.

Первым делом устанавливаем тип контента — text/html (потом можно сменить в самих методах) и кодировку — UTF-8.
Дальше проверяем, что у нас что-то запрашивают. Если нет то выводим JSON c ошибкой.
Если есть параметры запроса, то подключаем файл движка API — apiEngine.php и создаем класс движка с переданными параметрами и делаем вызов api метода.
Выходим из цикла так как мы решили что будем обрабатывать только один вызов.

apiEngine.php

Вторым по важности является класс apiEngine — он представляет собой движок для вызова api и их методов.

apiConstants.php

Данный класс используется только для хранения констант.

MySQLiWorker.php

Класс-одиночка для работы с базой. В прочем это обычный одиночка — таких примеров в сети очень много.

apiBaseClass.php

Ну вот мы подошли к одному из самых важных классов системы — базовый класс для всех API в системе.

Как видно данный класс содержит в себе несколько «утилитных» методов, таких как:
конструктор в котором осуществляется соединение с базой, если текущее API собирается работать с базой;
деструктор — следит за освобождением ресурсов — разрыв установленного соединения с базой
createDefaultJson — создает дефолтный JSON для ответа метода
fillJSON — если подразумевается что запрос вернет только одну запись, то данный метод заполнит JSON для ответа данными из первой строки ответа от БД

Создадим свой API

Вот собственно и весь костяк этого API. Теперь рассмотрим как же это все использовать на примере создания первого API под названием apitest. И напишем в нем пару простых функций:
одну без параметров
одну с параметрами и их же она нам и вернет, чтобы было видно, что она их прочитала
одну которая вернет нам бинарные данные

И так создаем класс apitest.php следующего содержания

Для удобства тестирования методов, я дописываю к ним адрес по которому я могу сделать быстрый запрос для тестирования.

И так у нас три метода

helloAPI

Это простой метод без параметров. Его адрес для GET вызова www.example.com/api/?apitest.helloAPI=<>

Результатом выполнения будет вот такая страница (в браузере)

helloAPIWithParams

Этот метод принимает в параметры. Обязательным является TestParamOne, для него и сделаем проверку. Его его не передать, то будет выдан JSON с ошибкой

helloAPIResponseBinary

И последний метод helloAPIResponseBinary — вернет бинарные данные — картинку хабра о несуществующей странице (в качестве примера)

Как видно — здесь есть подмена заголовка для вывода графического контента.
Результат будет такой

Есть над чем работать

Для дальнейшего развития необходимо сделать авторизация пользователей, чтобы ввести разграничение прав на вызов запросов — какие-то оставить свободными, а какие-то только при авторизации пользователя.

Ссылки

Для тестирования выложил все файлы на github — simpleAPI